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The Internet is creating plenty of excitement among 
developers these days. And plenty of extra work, too. 
With Microsoft's Visual Tools you can build on what 
you already know and count on the support you've come 
to expect from Microsoft.® We've focused on Internet 
standard: so you know what you build today will work 
tomorrow. For instance, with Microsoft Visual J++™ 
development software, you get Java" language within a 
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proven, full-featured environment. 
Create your own ActiveX™ controls 
^— - n etwark with Visual C++® development system 
to add Internet functionality. With Visual Basic® Scripting 
Edition built right in to Internet Explorer 3.0, you can 
automate objects and activate Web pages faster. Use 
Microsoft Visual SourceSafe™ version control system to 
coordinate team Website development and maintenance. 


As you'd expect, we’ll help keep you current with the 
latest technofogies, Visit www.microsoft.com/workshop/ 
for hundreds of lines of sample code, free controls, and 
information. Stay up to speed with the Microsoft 
Developer Network and learn with the Mastering 
Internet Development interactive training CD. Join 
the SiteBuilder Network and get even more support. 
Remember, you're not in this alone. 


Microsoft 


Where do you want to go today? " www.microsoft.com/devonly/ 


want to go today? are trademarks of Microsoft Corporation. Java is a trademark of Sun Microsystems. To order any of the Microsoft visual Tools, or to receive a reseller referral, 
(3:00AM to 7:00PM). Outside the US and Canada, please contact your local Microsoft subsidiary, TT/TDO is also available at (300) 892 5234, 
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UNIT AND REGRESSION TESTING 18 

by Adrian McCarthy 

Testing a function, module, or object in isolation from the rest of the program—referred 
to as “unit testing 5 —coupled with rerunning tests to detect unexpected changes in 
behavior (' regression testing") can dramatically reduce your bug counts. Adrian 
describes how to build effective units tests and automate regression testing. 

A DEBUG/TRACE TOOL 22 

by Rainer Siam 

The debug/trace tool Rainer presents here is useful when you don't have a powerful 
debugger at hand, and also when you need to build trace functionality into your code 
for error-spotting support at the client s site. 

JAVA GUI TESTING 30 

by Alan Walworth 

As Java development takes off, so does the need to test GUI applications written in Java, 

Alan examines Java GUI testing issues and presents a test harness written in and for Java. 

A DISASSEMBLER WRITTEN IN PERL 36 

by Tony Zhang 

Tony presents the core subroutines of a disassembler written in Perl. Although designed 
for Intel’s x86 instruction set, you can easily modify or customize the disassembler for 
your own applications, 

EXAMINING THE WINDOWS NT FILESYSTEM 42 

by Mark Russinovicb and Bryce Cogswell 

Mark and Bryce open up the inner workings of the NT filesystem by describing how a 
filesystem request originates in a user's program and ends up as a disk access, They also 
present an application called Filemon that monitors and displays all filesystem activity. 



Cover Autograph by Michael Carr 



EMBEDDED SYSTEMS 

ROBOTS AND FINITE-STATE MACHINES 50 

by Everett R Carter, Jr. 

Designing and building autonomous robots presents a host of technical challenges. Our 
author focuses on one of these challenges, describing the high-level processing he 
implemented in designing a robot-control system. 

NETWORKED SYSTEMS 

UNIX FILESYSTEMS WITHOUT I-NODES 60 

by Volker Lendecke 

The Linux kernel nfs, smbfs, and nepfs filesystems make it possible to link Linux 
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machines to file servers across a LAN—even though Microsoft’s SMB protocol is not 
designed to handle UNIX clients like Linux, Volker presents a workaround for this 
limitation. 

PROGRAMMER'S T 0 0 L C H E S T 

EXAMINING C++ PROGRAM ANALYZERS 68 

by Scott Meyer's and Martin Klaus 

Our authors examine a bevy of off-the-shelf tools that parse and analyze C++ source 
code, enabling you to detect troublesome C++ code via static analysis. 

TESTING TESTERS 76 

by Ron van der Wat 

In an ideal world, development progresses smoothly from requirements to completion, 

In the real world, errors creep in. Ron examines a collection of commercially available 
automated testing tools that aid in ferreting out those errors. 
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PROGRAMMING PARADIGMS 91 

by Michael Swaine 

Apple, Java, and the BeRox are on Michael's mind this month. 

C PROGRAMMING 97 

by At Stevens 

A1 presents MIDI Xchg, a program that tests the MIDI data stream by sending event 
messages from one device to another as fast as passible. 

JAVA Q&A 103 

by Cliff Berg 

This month, Cliff shows how you can use java's distributed programming model and 
access a SQL database from a Java applet. 

ALGORITHM ALLEY 107 

by Oleg Kiselyov 

Hoping to find die most efficient line between two points, Oleg examines scheduling 
algorithms and NP-complete problems. 

UNDOCUMENTED CORNER 111 

by George Shepherd and Scot Wingo 

George and Scot continue their examination of the CSpUiterWnd class, this month 


showing how you can apply knowledge of the CSplitterWnd internals to solve common 
MFC programming problems. 

PROGRAMMER’S BOOKSHELF 117 

by Phil Mitchell 

Phil goes back to the future in his look at Thomas Landauer's The Trouble With 
Computers and The Future of Software, edited by Derek Leebacrt. 
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As a service to our readers, all source 
code is available on a single disk and 
online. To order the disk, send 314.95 
(California residents add sales tax) to Dr. 
DoWs journal 411 Bored Ave., San 
Mateo, CA 94402, call 415^554100 x5701, 
or use your credit caid to order by tax, 
415-358-9749, Specify issue number and 
dale. Code is also available through the 
DDJ Forum on CompuServe (type GO 
DDj), via anonymous FTP from site 
ftp.mv.com (192,80.84.3) in the /pub/ddj 
directory, on the World Wide Web at 
http;//www.ddj.com, and through DDJ 
Online, a Free service accessible via direct 
dial at 415-358-8857 (144 kbps, 8-N-l), 

NEXT MONTH 


Once shunned as AI off-shoots, intelligent 
agents have found new life on the World 
Wide Web, In March, well look at the 
issues and technologies behind mobile 
agents. 
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Q: What does it take to deploy a 
superior client/server application? 
A: A SUPERIOR SERVER 


c-tree P us 


FairCom Server 


Complete C Source 
Single/Multi User 
CJienl/Server (optional) 

Hull ISAM functionality 
No Royalties 
Transaction Processing 
Fixed/Variable Length Records 
High Speed Data/Index Caching 
Batch Operations 
File Mirroring 
Mulliple Contexts 
Unsurpassed Portability 


* Chent/Scrvcr Model 

* Transaction Processing 

* Requires <2MB RAM 

* QnJine Backup 

* Disaster Recovery 

* Rollback - Forward 

;ords * Anti-Deadlock Resolution 

aching * Client-side M C" Source 

* Multi-threading 

* Heterogeneous networking 

* File Mirroring 

* OEM/Source Available 
CIRCLE NO. 84 ON READER SERVICE CARD 

FDR YOUR NEXT PROJECT CALL FAIRCOM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTION* 

Also inquire about these FairCom products: 

d-tree™ r-tree® ODBC Driver 


FA RCOM 


CORPORATION 


■few WWWeb Address: http://www.faircom.com/ 

p S00-234-8180 

* U .S.A. 4006 W. Broadway - Columbia, MO 65203-0100 

phone (573) 445-6833 fax (573) 445-9698 
EUROPE Via Patriot!, 6-24021 Aibino (BG) - ITALY 
phone (035) 773-464 fax (035) 773-806 
JAPAN IKEDA Bldg. #3,4f-112-5, Komei-chou - Tsu-city,MIE 514 Japan 
phone (0592) 29-7504 tax (0592) 24-9723 


You can’t find a better client SDK with these features! 
Over sixteen years of proven reliability and performance. 
No one else supports over 30 platforms in this price range! 


START with the most 
advanced client-side SDK on 
the market: c-tree® Plus at 
$895. 

• Complete “C” Source code 

• ROYALTY FREE (Client Side) 

• Multiple supported protocols 

• Fast, portable, reliable 

• Powerful features like 
transaction processing 

• Win95 t NT, and 
Windows 3.1 ready 

ADD a strong, multi- 
platform, industrial-strength 
Server that supports. 

• File mirroring 

• Heterogeneous networking 

• Automatic disaster recovery 

• M uiti-threaded design 

• Best price/performance 
available: from $445- $3745 


RESULT? A solid, 
economical, easily 
deployable product that fits 
your needs. 

* Portable 

* Scalable 

* Exceptional Performance 

* Flexible 

* Easy Server distribution 

* Convenient OEM terms 

FAIRCOM 

Server* 


Heterogeneous TCP/IP Network 


• SUN O/S 4.X • SUN O/S 5.X • MIPS ABI (SGI) 
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L As Mot As JAVA and VKMM 


JAVA and VRML have taken the internet market by storm with cutting edge development tools. But, 
BoundsChecker ' 4.0 for Windows NT emerged as the 1996 PC Magazine Technical Excellence 
Award winner. Not hard to believe when over 80,000 developers already know that programming 
applications — internet or otherwise — require the best tool available. When your software 
quality is on the line, you need a proven dependable error detection solution. Make sure you 
use the best development tool for error detection. Use award-winning BoundsChecker. 


L>ounds(Jheeker catches the most errors. 

BoundsChecker is the award-winning Advanced Error Detection tool for 
Windows. It catches API and OLE errors, Windows OS specific errors and C/C++ 
language errors — plus all of your static, stack and heap errors. BoundsChecker is 
ideal for component-based development. 




,5 mar t [Debugging™ means you spend less time debugging. 

Its integration with the Visual C++ IDE enables powerful, transparent 
error detection as you do your normal debugging. There is no extra 
work on your part...errors are found...the exact location pinpointed 
and a correction suggested. 

|t’s a Windows expert so you don’t have to be. 

BoundsChecker performs active API validation on more than 
3,000 Windows APIs and OLE interfaces, including Win32*, 

ActiveX DirectX ODBC and many more. 

[download a E ree Evaluation C°pj at 
www.numega.com 

or C.all I -300-4-NUMLGA (S00-46d-<£)42) to order 




NuMega 

XI ioilNDSOcCKS* 

Advanced Error Detection” for Windows 


9 Tgwrviesid W«t - NH 03063 * 603 8W-23&6 • 300 ^NUMEGA 

fa* 603 0B9-1136 * rnfo^numega .com * R iRnwga. coir; 

NiffoTegn Technologies, ’ha NuMagn logo, Brw itcLGhecker, tha Bounds Checker logo, and 
Advanced trrer DeteeNon are trodemorb of NuMeaa TechnolKjrei Inc All other Iradeniorb . , . 

ore the property of Ihsir respective owners Copyright ©! 996 , All flghtr reserved AAdking bortWQre Work 


NuMega 

Tech no log i e 5 


n 


indows 

Dcch 


Star 


CHOICE 


,1 
Choice 


»996 

MjWW SOJUOSChECVER 4<1 OEVEtORMENr TEAM 
BOf&ZftOm *0 PfiOPESSWMt EOfTKiw erjt mo 0WS Nr 
HUMEGA TECHNOLOGIES. INC 
DF-/FLOPMFNT TOOLS CATEGORy 


CIRCLE NO. 342 ON READER SERVICE CARD 












EDITORIAL 


Power Plays 


T he high-tech electricity meters recently installed hereabouts continue to undergo testing, fn 
replacing conventional meters, the utility company went house-to-house, plugging in new 
ones capable of transmitting and receiving data wirelessly. Like buggy whips and automobile 
fins, human meter readers are dust in the wind, at least in this burg. (Darn, there goes another 
career option,) Now, meters all over town fire up once a month, letting the central billing office 
know if Tom Bodett and the local Motel 6 really did leave a light on. 

All in all, the local electrical provider installed more than 36,000 new meters that can 
transmit/receive data at 900 MHz within a range of 750 feet. Communicating with the meters are 
700 intermediate antennas attached to streetlight poles around town. In turn, these intermediate 
devices communicate at 1,4 GHz with three primary antennas linked via fiber-optic land lines to 
the billing office about 30 miles away. It is the intermediate antennas that are (literally) driving 
engineers batty. 

Wltile there aren't a lot of tall buildings and high hills in town, there are plenty of tall trees to 
interfere with low-power radio transmissions. Consequently, utility engineers are having to test 
and retest to find the optimum layout for the intermediate antenna grid. Not wanting to miss a 
billing cycle in the meantime, "meter readers” are slowly driving a van—loaded with portable 
computers—up and down die city streets, activating meters and collecting data. At least in this 
case, mobile computing is just that. 

Since big cities such as Denver, Pittsburgh, Spokane, and others already have similar systems 
up and running, it's a safe bet that the challenges in this small town aren't unique and will be 
resolved. As in those big cities, die system here is die Genesis Fixed Network automatic meter¬ 
reading system from Itron (Spokane, Washington). In addition to standard meter-reading 
capabilities, the system can provide daily readings, real-time on-demand readings, start-and-end 
of service readings, time-of-use readings, outage detection, and the ability to monitor inactive 
accounts for unauthorized usage. The system also can determine peak/off-hour power patterns; 
die utility companies may start billing us for electricity like phone companies do for long-distance 
phone service. 

There's a power play of a different sort going on in Washington, D.C., at least in terms of 
software patents and copyrights. In particular, proposals in Congress would move the copyright 
office out of the Library of Congress and into the executive branch, specifically under the 
auspices of the Commerce Department's US. Patent and Trademark Office. The result would be a 
new “office of intellectual property policy," Bellind the shift is the Commerce Department's desire 
for more control over intellectual property when setting international trade policy and negotiating 
trade deals, Less clear is how this change would actually benefit content owners. 

This bureaucratic move is confounding because, as Joseph Yang points out in his excellent 
paper “Patenting Content: The Expanding Role of Patent Protection for Internet-based Information 
Products* (http://www.alumni.calteeh.edu/~yang/), the distinctions between copyright and 
patents are blurring, in part due to executable content (aka “applets"). Historically, says Yang, 
who is both a patent attorney and an engineer, patent protection has been for functional aspects 
of a computer program, while copyright has protected its expressive elements. Today, however, 
the trend is toward merging copyright and patent concepts and enlarging the scope of patent 
protection for software. This is die stance put forward in the PTO’s new “Examination Guidelines 
for Computer-Related Inventions." 

Especially during these periods of transition, patents continue to be a topic of vital importance 
to software developers. According to Greg Aharonian and his Internet Patent News Service, iw'o 
significant trends related to software patents evolved in the first half of 1996: 919 network- 
software patents were issued (almost double the second-place count of 528 image-processing 
patents), and Microsoft moved rapidly into the software-patenting ranks. In 1995, Microsoft 
ranked 24th in the number of patents issued; in the first half of 1996, it climbed to 12th. When 
everything is totaled up, Aharonian predicts that 8100 new software patents will have been issued 
in 1996— almost as many as were issued in 1992, 1993. and 1994 combined, 

In other words, in the four-year period between 1993 and 1996, approximately 20,000 software 
patents will have been issued. Now ask yourself if you really believe 20,000 novel innovations 
have been developed in the software world during that period. Yes, changes are needed in the 
copyright and patent arena, but the proposals on the table aren’t intended to address the real 
problems. 



Jonathan Erickson 
editor-in-chief 
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Always test your 
architecture as though 
the worst is yet to come. 


W hy you should put your application 

to the test witfi Rational Visual Test: 

* Maximize resources by automating 
testing across all ymir PCs, saving 
time and reducing human error . 

* Create test scenarios instantly 
with the scenario recorder ; or 
use a sophisticated editing and 
debugging environment. 

• Test Windows-based applications 
written in any language t and log 
the results to your database of 
choice. 

• Get the power to test 32-bit 
applications, ActiveX controls 
and DLL fries. 


Presenting Rational Visual Test, the industry's 
easiest way to integrate automated testing into the 
development process. There are plenty of good reasons to test an application 

prior to implementation. No one wants to deploy a less than top-quality product. But how can you prevent failures both 
now and in the future, as you make modifications two, three or even five years down the road? 

The answer lies in automated testing during the development process. After all. 
software quality is not only the result of well-planned design, but also the elimination of 
random errors Rational Visual Test allows you to retest your application automatically at 
every stage of development. Unattended, across every PC in your operation Which means 
you discover errors early in the process and deliver better software in less time 

Of course, higher software quality contributes more than shorter development 


* Utilize the Advanced Error 
Detection 1 "system from N ufAega" 
boundsChecker 1M 
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time. Fewer maintenance upgrades cut shipping and marketing costs. Higher profit margins result from a reduced 
need for technical support. And greater customer satisfaction tends to have an obvious effect on your bottom line. 

To find out how Rational Visual Test (originally sold as Microsoft Visual Test) can enhance your 

application development visit our web site (www.rationai.com/vtestj or call 1 - 800 - 728 - 1212 , ext. 214 today. 

RATIONAL 

SOFTWARE CORPORATION 

© 1996 national Software Corporation, 2SQ0 San Tomas Expressway, Santa CEara, CA 95051-0961. All riglils reserved. Telephone 4QM96-3BOO, Fax 408^96-3636, E-mail inTo@rallonal.com 
Canada 613-599-3581; France *33-1-30-12-09-50; Germany +49-09-797-021; L.K. +44-1273-624814; Sweden +46-8-703-4530; Australia +61-2-9419-3455; Taiwan +886-2-720-1933. Korea +82-2-579-3926: 
India +91-69-553-8082; Brazil +55-021-571-2973. Representatives: Israel +972-3-531-3333: Japan +81-3-3779-2541. 
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Build Rome in a day. 

It's easy with Symantec Visual Cafe for Java^ 



'Gffet e*piras Feb. 2a.. 1997. Symantec is a registered trademark and Visual Cafe is a trademark of Symantec Corporation. Java is a trademark oF Sun Microsystems. Inc Windows is a registered trademark 
of Microsoft Corporation. Macintosh is a registered trademark oF Apple Computer, Inc. Netscape Navigator ls a trademark of Netscape Corpora]Ion. All other brand names or trademarks are property of their 
respective owners. €1996 Symantec Corporation. All rights reserved. In Canada, call 1-000-365-6641. In Australia. call 02-879-6577. In Europe, call 31-71-535-3111 
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Visual Java Development 


Develop faster. Compile 
faster. Debug faster. Realize 
your Java * 1 dreams faster. 

p Symantec, the creator of 
the first full-featured Java 
development environment now unleashes 
the first Rapid Application Development 
environment for Java developers: 

Symantec Visual Cafe . 1 ' 1 



Visual Cafe comes complete with an 
extensible component library with all of 
the building blocks for your application, 


Simply drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify the actions 
and events. And then Visual Cafe 
automatically generates the Java code. 




And thanks to our exclusive two-way 
programming you can add or modify the 
code at the source level too. 


So, you'll be whipping out prototypes at 
speeds you can only dream of now. 



imagine building all your forms visually. 
Or building your user interface without 
writing one single line of code! ► 


Visual Tools for Windows^ 


As an added bonus, Symantec's 
Just In Time compiler (JIT) (Included 
in Netscape's upcoming Navigator*) 
runs your Java applications faster 
than any other browser or Java virtual 
machine on the planet. 

So get your hands on the hottest 
new development tool for Java now. 

Buy Visual Cafe today for just 
$199*and receive a $40.00 maiMn 
rebate. Purchase your copy online 
at cafe.symantec.com. Or pick up 
a copy at the MicroCentert Fry’s, 
CompUSA or Egghead nearest you. 
For more information, please call 
t-800-453-1059 ext. 9A31. 


Visual Tools for Macintosh!! 
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Small C Appeal 

Dear DDJ, 

I'm appealing to your readers for help in 
finding a copy of the book A Small C Com¬ 
piler by James E, Hendrix, The publisher 
put it out of print, If anyone has a copy 
they Ye willing to sell, please contact me. 

Martin Schaaf 

P.O. Box 761 

Alameda, CA 94501 

DDJ responds: Martin, in response to re¬ 
quests like yours, we Ye about ready to re¬ 
lease Ok Dobb’s Small C Compiler Resource 
CD-ROM that wall include the full text to 
Jim's book A Small C Compiler: Language, 
Usage, Theory, and Design, collected DDJ 
articles on Small C, several implementations 
of the compiler, and related Small C tools. 

Expanding Retail Channels 

Dear DDJ 

I enjoyed reading Jonathan Erickson’s 
November 1996 editorial and wholeheart¬ 
edly agree with his assessment of how dif¬ 
ficult it can be for software publishers to 
get placement in the retail channel Our 
company, Online Interactive, offers an al¬ 
ternative solution for software publishers 
trying to distribute their products. Online 
Interactive operates a series of electronic 
download stores called the "atOnce Soft¬ 
ware"’ stores (http://ww w,atonce.com), Our 
first store opened on die Internet in Jan¬ 
uary, 1996 and was one of the original par¬ 
ticipants in Microsoft’s electronic software- 
distribution pilot program. Since then, we 
have opened additional stores on America 
Online, CompuServe, and the Microsoft 
Network, We have licensed over 125 soft¬ 
ware publishers. Including GT Interactive, 
Intuit, and Asymetrix; more importantly, 
we represent a host of smaller publishers 
that are successfully using the download 
channel to generate revenue and reach cus¬ 
tomers, With over 1500 titles available for 
instant delivery, we wall soon surpass the 
selection of even die largest computer su¬ 
perstores. 

Robert Nachbar 

RobertN ©online- interactive .com 


Goal-Directed Design 

Dear DDJ, 

Alan Cooper’s September 1996 article 
“Goal-Directed Software Design" presents 
laudable principles. However, I’m always 
concerned when realistic examples don’t 
derive from principles. 

What really caught my eye was the 
caption for Figure 4: “The monthly view 
in Schedule* is a paragon of pixels sac¬ 
rificed on the altar of meaningless regu¬ 
larity.” (The figure itself shows a tradi¬ 
tional paper-style monthly calendar layout 
displayed on a computer screen with lots 
of wasted space.) 

My technophile instinct wanted to jump 
up and applaud Cooper for advocating a 
move away from now-irrelevant limita¬ 
tions like the static nature of information 
presented on sheets of dead trees. And I 
certainly wouldn’t choose to defend a Mi¬ 
crosoft product under ordinary circum¬ 
stances. Unfortunately, a few seconds lat¬ 
er I realized there was a problem. 

For in-house corporate developers, it 
might be possible to provide a more dy¬ 
namic display or at least one which wastes 
less screen real estate. In this situation, 
users are haunted by the twin specters of 
necessity and inflexibility : The software is 
more likely to be mission-critical and less 
likely to be provided by more than one 
vendor. Users here are more likely to be 
willing to slog through the (admittedly 
small) paradigm shift because they’ve lieen 
shifting dais way for years to accommo¬ 
date alien software. 

But for independent software vendors 
who must induce skeptical and often 
deeply conservative customers to part with 
hard-won cash, imposing a new calendar 
display paradigm is no way to win mind- 
share + These users are more likely to greet 
unfamiliar displays of familiar data with 
knee-jerk rejection or MEGO (“my eyes 
glaze over”). According to Cooper, this 
might be the user’s fault; Cooper might 
say the user has a “false goal,” But edu¬ 
cating users is not usually die job of a soft¬ 
ware interface designer. 

Of course, it's possible to satisfy all users 
by providing lx)di a traditional and a more 
efficient calendar display. However, it’s 
not always practical to develop both. 

Hie principles of goal-directed user in¬ 
terface design sound good, but I’m still 
waiting for a “killer” case history. 

Pete Gontier 

Pleasanton, California 

Gurgle@aol.com 

Dear DDJ, 

1 read Alan Cooper’s article “Goal-Directed 
Software Design” {DDJ, September 1996) 
with interest, having previously read his 
book About Face : Generally speaking, what 


he writes expresses dearly what I feel, al¬ 
though we occasionally disagree. 

The disagreement at hand concerns the 
phrases on page 18 (DDJ) \,.an embar¬ 
rassment of compute-cycle riches.” My 
biggest complaints about die software 1 
use are generally: 1. bugs, and 2 r slow¬ 
ness. The article didn’t talk a lot about ihe 
Bane of Software—bugs — but maybe 
they’re more of an implementation than 
design issue (maybe not always, though). 
But on slowness, he doesn't even seem to 
think it exists! 

it has been my experience that no mat¬ 
ter how fast the hardware, I end up wait¬ 
ing, wondering what on earth the pro¬ 
grammers have cooked up to waste the 
time. I guess we agree to the extent diat 
nowadays I tend to blame the software 
more than the hardware, 

Stuart Ambler 

Longmond, Colorado 

Java Response 

Dear DDJ, 

I would like to take this opportunity to re¬ 
spond to some criticisms of Java diat were 
made by Luca Passani in his letter in the 
September 1996 DDJ There are a number 
of criticisms of Java that Luca makes, that 
are inaccurate and misleading, 

Luca’s statement that Java applets can’t 
and never will be able to write to the lo¬ 
cal filesystem is incorrect, The current re¬ 
striction on access to the local filesystem 
is not a restriction imposed by Java, but 
is rather a restriction imposed by 
Netscape’s Navigator, Web browsers can 
create security managers which allow for 
any degree of granularity of access to lo¬ 
cal system resources—Sun's Hotjava 
browser, for example, allows applets to 
write to directories on a user-specified ac¬ 
cess list; future browsers could implement 
more complex security managers. For ex¬ 
ample, a security manager could be writ¬ 
ten that albws applets that are loaded from 
specific hosts, carry a specific public key 
signature, and so forth, access to speci¬ 
fied directories in the filesystem. Luca’s 
contention that the only alternative to “no 
access to the local filesystem” is “Full ac¬ 
cess to the local filesystem” is incorrect. 

Luca also contends that no “serious ap¬ 
plications” have been written in Java, and 
diat Java is too slow to download and run. 
His first claim is patently false; I point to 
Sun's Hotjava browser and Java Workshop 
development suite as examples of “seri¬ 
ous applications” written in Java, The fact 
that there are many “eye candy” Java ap¬ 
plets out there is a function of the fact 
that, until corporations start adopting Java, 
hobbyists (such as myself) will continue 
to be the primary users of java. Howev¬ 
er, that trend is changing rapidly, and I 


10 


Dr Dobbs journal, February 1997 





Real-Time Graphics Tools for windows? 

Program 16 or 32-bit applications using Rev. 2.5 



General Features 
El 16 and 32 bit DLLs 
El Compatible with 
Windows 3,1, 

Windows 95 and 
Windows NT™ 

El Supports VisualC++™, 
Borland C++™, Visual 
Basic™, Borland 
Delphi™ 

El Royalty Free 
[El Bitmap and metafile 
support 

m MDl, OWL and MFC 
compatible 

IS! Print to any Windows 
supported printer 
SI DDE support 


Dynamic Plots 

(El Scrolling graphs 
El Scrolling graphs with 
variable sample 
intervals 

El Sweep graphs 
El Logic graphs 
El Scrolling bar graphs 
El XY plots 
El Dynamic bar graphs 
El Dynamic text 
El Text messages 
E3 Alarm messages 
El Annunciator panels 
S3 Needle, arc, and pie 
meters 


El 32K points per trace 
El 32 traces in a single 
graph 

E3 Historical data buffers 
El Auto scroll graphs 
El Formatted FID bar 
graphs 

El Auto bar graphs 
El Auto text displays 
El Alarm checking and 
reporting 

El Dynamic time axis 


Static Plots 

E3 Line plots 
El Horizontal and 
vertical bar graphs 
El Scatter plots 
El Pie charts 
El Floating bars 
El Group plots 
El High-low-close plots 
El Area plots 
El Error bar charts 
El Auto axes scaling 
El Number of data 
points/ lineplot can 
exceed 10 7 

El Mix different plot 
types within a graph 


The Graphics Class Library for MFC, a class library version of the 
Real-Time Graphics Tools, is also available as a $200 add-on. 


Miscellaneous 
E3 Zooming 
El Data cursors 
E3 Scroll bars and buttons 
El LED indicators 
El Axes labels in numeric 
or time formats 
El Edit charts with dialog 
boxes or editing 
functions 

El Multiplex cry axes 
El Multiple scalings 
El Legends 
m FFT 
E] FID control 
El Mouse support 
El Data compression for 
fast display updates 


Request or download our demo disk! 

Telephone: 617/ 449-6155 
BBS #: 617/ 449^783 
WWW: hup;//wvvw r quinn-curtis,com 
FTP: at ftp.webcom.com in /pub/quinn/demofiles 

Quinn-Curtis, Inc • 35 highland circle • needham ma 02194 usa • tel 61/7449-6155 • fax 617/449-6109 

Windows and Visual Basic arc registered trademarks uf Microsoft Carp, AlJ other products arc trademarks or registered trademarks of iheir respective owners. 


Real-Time Graphics Tools for Windows DLL $600 

Real-Time Graphics Tools for Windows DLL & Source $1200 

Specify C/C++, Delphi or Visual Basic version when ordering 




























































(continued from page 10) 

see this balance shifting rapidly over the 

next year or two, 

Luca also compares die relative com¬ 
plexity of Java (requiring “professional de¬ 
velopers for not so complex applications”) 
with the simplicity of HTML, This is a 
flawed comparison, as HTML is not a pro¬ 
gramming language, A much better com¬ 
parison would be to compare Java with 
C++ or Perl, both of which require de¬ 
velopers w ith some degree of skill for even 
fairly simple programs. Users who are sim¬ 
ply building web pages can download and 
use any number of prewritten Java applets 
(the Gamelan repository is one such 
source of applets). Custom solutions have 
always and likely wall always require pro¬ 
fessional developers. 

Also, Luca makes the statement that it is 
better to use other RAD tools and TCP/IP 
client/server approaches than to “waste time 
and money trying to make your require¬ 
ments fit die Java paradigm." I utterly fail 
to see how die “Java paradigm,” as he puts 
it, is any different from any other OOP pro¬ 
gramming paradigm. In fact, it is my ex¬ 
perience that developing complex TCP/IP 
client/server applications in Java is signifi¬ 
cantly easier dian developing them in C or 
C++. The language is somewhat different, 
but there is no dear advantage to other 


RAD solutions, except in the area of GUI 
builders. And the drag-and-drop GUI 
builder (such as Delphi's, for example) is 
already available for Java from at least one 
vendor. (Rogue Wave's JFactory. ) I do not 
see a disadvantage to using Java here, and 
in fact, Java lias several advantages in terms 
of security and network programming. 

! will concede that there are some bugs 
in the current implementation of the AWT 
toolkit. However, as time goes by (java 
is, after all, barely a year old), and these 
issues are resolved, Java will become diat 
much stronger. Luca's criticism of the 
speed penalties for downloading and run¬ 
ning java applets can and will be resolved 
as both Internet bandwidth increase and 
mechanisms are developed for caching 
applets. Luca's criticism of “...having to 
download a Java .PDF-life reader every 
time you encounter a ,PDF document” 
only remains valid if you assume that you 
have to download the applet every time. 
If a mechanism could be created where¬ 
by the applet could be downloaded and 
Stored persistently on your local hard drive 
(and such a mechanism is not difficult; 
Netscape’s Navigator already does some 
caching of applet data), this would turn 
Into an advantage rather than a disad¬ 
vantage, (I’d rather download 2Q0K of 
compiled Java code than a 4-MB ZIP file, 


which I had to install on my system, for 
example.) 

In summary, I feel that Luca's criticisms 
of Java are based on an incomplete un¬ 
derstanding of exactly where the limita¬ 
tions in the current implementations of 
Java-based technologies lie, and that his 
comments are extremely misleading. The 
majority of the limitations currently en¬ 
countered in Java applets are limitations 
not of the applet, nor of Java, but of ei¬ 
ther the web browser or the hardware net¬ 
work connection. Java certainly does have 
some limitations, which will be solved as 
more people adopt Java and more effort 
goes into resolving those limitations, but 
the arguments that Luca makes against 
java are incorrect and misleading. 
Matthew Cravit 
Palo Alto, California 
m era v it ©best, com 

DDJ 

DDJ welcomes yoit r comments and sug¬ 
gestions. Send letters to DDJ, 411 BarelAw ,, 
San Mateo . CA 94402-3522. We can also 
be reached via editors®ddj.com, 76704 
50@comptmrve.com, and by fax atr 415- 
35^-9749, Please state your name and ad¬ 
dress. DDJ resenm the right to edit letters 
for length and/or content . 


3] There Are Enough Details in the Average 
Software Project To Make Your Head Spin. 

Take Control with Track Record ! 0 The award-winning development tool far tracking bugs, features, releases, and more. 


If y on Ye a software developer, project manag¬ 
er, or QA engineer, you need an easy, reliable 
way to: 

* Keep track of whats been done, what's left to 
do, and where the problems are. 

1 Stay on top of bugs, features, and changes. 

1 Figure out who did what, when, and why. 

In other words, you need Track Record 3.0, 
the top-rated development tool from the 
people who created the revolutionary 
BRIEF® editor. 

Track Record keeps you 
on top of the details. 

Track Record not only tracks bugs from first 
report through reproduction, fixing, and test¬ 
ing. It also puts you in control of the entire 
development cycle, helping you improve soft¬ 
ware quality. It lets you track feature 
requests... the release a bug fix is in,.. 


bug reports by priority, developer... and virtu¬ 
ally anything else you're interested in. It even 
keeps a running history for future reference. 

Most important, Track Record is easy to use. 
With pre-designed data types, reports, charts, 
and more, you're ready to take control right 
out of the box. Working in teams is easier, too. 
Why? Because Track Record keeps everyone 
up to date— automatically. 

What's more, Track Record's fully customiz¬ 
able, object-oriented database gives you the 
power to track any kind of information. You 
can even track bugs across several projects 
at once. 


Just $195 

Risk-free, money-back guarantee 
Calf for details on client/server version 



Order now—and find oul why the 
experts rave about Track Record. 

Track Record helps all kinds of people take 
control of the details—and write better soft¬ 
ware. People tike Neil Soane of Mindscape 
International, who says: "Track Record helps 
us keep our support people connected and 
helps us focus on improving our software. We 
couldn’t do without it.” 

And the trade press definitely agrees: “Track 
Record is clearly the technology leader—the 
most flexible and sophisticated of the bug 
trackers” — Data-Based Advisor, lune, 1993 

To order, call: 

800-343-7308 or 617-267-9743 



Track Record L a registered trademark of UnderWare, Inc. 


Under Ware. Inc., 321 Columbus Avenue. Boston, MA 021 (6 USA * Fas 617“ 4 24- 1839 ■httpWwww. uw.com 


CIRCLE NO. 1T2 ON READER SERVICE CARD 

















7 k*fi?***< 

°««s^yro oIi 


ts m 

"Powersofts ncx 

niaies creatine ( 

^c ++aft |; 

fsseiSh* 


-vaopnienttooi T 

P?^app/ itations V 

ldJ ^pencnce.” 

’ivlopnietit, 

■rfiil product that 
se of VB’s component 


“A C++ Tool That Cures VB Envy 

Rick Grehan, B YTE, October 1996 


u Opunia++ is a pc 

combines the ease 

“Powersoft has scored a home run, 

Dan Rogers, Software Development, September 19 > 
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• Over 220 components and classes 

■ Build and exploit Powersoft* Delta Window 

* Native drivm Jhr Sybase*', Microsoft, 

Qmck> Informix, DB/2, and more 

■ Scalable Sybase? SQL AnywherO" database 



* Build and debug CGI NSAPI f andlSAPI 
custom application servers 
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Experts agree. Optima* + comes out on top. 


Now you can deliver extraordinary 
solutions — at an extraordinary speed, 
Optima++™ revolutionizes develop¬ 
ment by allowing you to quickly build 
client/server and Internet applications 
using visual component assembly 
drag-and-drop programming and the 
full power of C++. 

For dient/server development, 
the new Data Window™ control gives 
you point-and-click database access, 
powerful extended attributes) and 
presentation capabilities made famous 


in PowerBuilder*, For Internet devel¬ 
opment, Optima++ delivers visual 
component assembly and seamless 
remote debugging so you can create 
high-performance applications and 
custom application servers. 

Choose the edition that’s right 
for you, Optima++ Developer delivers 
approachable C++ for client/server 
development. Optima++ Professional 
adds powerful features lor the corpo¬ 
rate developer including Data Window 
technology and Internet development. 


Qptima++ Enterprise takes scalability 
and performance to die next level 
with native database drivers and 
ObjeaCyde™ for team project 
management. 

So don’t just read about this 
revolutionary RAD tool. Download 
your Test Drive edition today and 
let Optima++ take your development 
to new heights! 

i Powersoft 


Get Optima++ Developer, Professional, or Enterprise today: 1-800-395-3525 or www.powersoft.com 

. ■ 1 1 >% Sybase. Inc. All rights icHtmd Sybase, iWersriii. Optima11.1 totaWiiuW, ObjtctCydi-,. fcwvrBuiltlcr, ami EiQj. Anywhere agn*tradtinarkt i»f bylm*- Inc, or its yub'ridiarics. All other ud*marks 
are property of their respective owners. Outside the U.S., ca!3 508-23?-1 SLUE Please check the RsMcfsait Web site for a complete listing ot the Jejcurcs in each edition. 
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Paradise No. Discount Price 

Dan Brie kiln's demo-rt! v2,0 WIN 3 1/2 

UDSD31-FT _ $299 

Delphi v2.0—New User CD-ROM 

B0DPT88-FT .$95 

Doc-To-Helpv2,1 

WTOH231-FT . $320 

HCL Exceed v5.1.3W!N/95/NT 

HBHEX88-FT .$389 

Mathematics v3,0 WIN95/NT 

W0MM388-FT.$1245 

MS Frontpage 97 with Bonus Pack 

MSFPB8B-FT .$139 

MS Mastering Internet Development 
CD-ROM 

MSIND88-FT ...$95 

MS Office 97 

Version/Co repetitive Upgrade 

MSOSD88-FT .$229 

MS Proxy Server 

MSPRX88-FT .$995 

MS Visual Basic Pro v4.0 WIN CD-ROM 

MSV4P88-FT .$469 

MS Visual C++ Subsc. v4.0 CD-ROM 

MSVC4S8-FT . $479 

MS Visual FoxPro v5.0 Pro Upgrade 

MSFPF88-FT .$265 

MS Visual J++ vl.O 32-bit CD-ROM 

MSJPP88-FT _S89 

MS Visual SourceSafe v4.0 MAC/WIN 

MSVSS88-FT ..$479 

MS Windows NT v4.0 Workstation 
CD-ROM 

MSWIA88-FT __$299 

MS Windows NT v4.0 Workstation 
V+C Upgrade 

MSWIB88-FT _ $139 

MS Visual C++ v4.2 Enterprise Upgrade 

MSVCF8B-FT .$469 

MSDN Professional Subscription 
WIN 95 CD-ROM 

MSDNC88-FT .$495 

Multi-Edit v7.1 Windows 

AMCME31-FT..$139 

PowerBuilder Desktop 5.0 WIN CD-ROM 

PWSPG88-FT .1189 

PVCSv5.2 WIN/NT/95 31/2 

1SPVP31-FT _ $449 

SuperCede vl.O Java Edition 

ASSUP88-FT .$99 

System Commander v3.0 3 1/2 

VCSC33I-FT .$69 

VB Assist v4.0 

SDVBD88-FT .$125 


Call for shipping charges/return policy. 
Prices subject to change without notice. 


Celebrate President's Day 
With These Top-Sellers! 


Olectra Chart 

by KL Croup 

Setting new standards for functionality 
and performance, Olectra Chart lets 
developers add stunning 2D end 3D 
graphs to their Windows applications. 
Olectra Chart offers developers more 
control over graph colors, styles and 
properties along with features like 
dynamic zooming, scaling and rotation. 
Available as 316- and 32-bit OCX and 
includes a fully documented C/C++ API 
and MFC and OWL wrappers. 
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Paradise No. 

KLQLF88-FT 

$239 


DbCAD dev 1.42 
16/32-bit DLL 
& OCX Royalty-free 

byABACOsrl 
Ingenious, powerful and easy-to- 
use library for Windows 3.x. 95 
and NT for vector data trass man¬ 
agement. Manages graphic window with 
zoom, pan, pick and overview commands, 
compatible with most standard vector and 
raster formats including DWG, DXF, WMF, TIF. 
BMP, RLE, RLC; also permits their display using 
transparency effect; partial loading of drawings. 
All that with intelligent functions to link your 
databases with each vector entity, allowing you 
to extend your application to support CAD, GIS, 
DTM, TDM and FM functionality. Royalty-free. 



Paradise No. 
ABDBE31-FT 

$1399 


WISE Installation 

by Great takes 
Business Solutions 
Creates professional installations 
for Windows. Windows NT, and 
Windows 95 all with a single 
installation script. The WISE 
Installation System includes both 
16- and 32-bit versions of the 
integrated development environ¬ 
ment, WISE includes all of the 
standard installation features plus: 
custom dialog/graphic editors; 
CD-ROM/Network installations; 
multi-lingua I support; and full 
Windows 95 install requirements. 



Paradise No. 
GLISV31 -FT 

$169 


c-trce Plus" 

by FairCom 

DOS • WINDOWS • NT • UNIX • 
OS/2 • SUN • RS6000 • HP9000 • 
MAC • QNX • BANYAN • SCO 
This well known, highly portable data 
management package has become 
established as the tool of choice for 
commercial development Offering 
unprecedented data control, 
choose from direct low level 
access, ISAM level, or ODBC 
access with the FairCom Server, 
Single User, Multi User, or optional 
Client/Server. ANSI Standard 
Full Source. No Royalties. 



Paradise No, 
FACTP31-FT 

$785 


Visual SQL* 

by Blue Sky * Software 
New I Visual SQL turns Microsoft 
Visual C++ and Visual C++ Enterprise 
Edition into full-blown Client/Server 
development environments. Visual 
SQL integrates seamlessly with 
Microsoft Developer Studio using 
intuitive wizards to generate MFC 
Client/Server code. Visual SQL 
builds on the power of Visual C++ 
and offers developers the best of 
all worlds: the rapid application 
development of visual tools such as 
Visual Basic and the high-performance 
of compiled C++ code. 



Paradise No. 
BLVSQ8a-FT 

$1395 


VTune 

by Intel Corporation 
Intel's Visual Tuning Environment 
for Windows* 

• Visual & Easy To Use 
Performance Methodology 

• System-Wide Monitoring 

• Identifies Performance Hotspots 

• Detailed View of Software 
Execution 

• Optimization Advice 

Come see us at SB 97 West- 
Booth #2126. 



Paradise No. 
INTVT88 -FT 

$129 


WinSCSI-32 

by Sequoia Advanced 
Technologies, Inc 
Full 32-bit SCSI commend link library 
with over 150 functions designed to 
make your SCSI application program¬ 
ming tasks easier, Complete with 
extensive sample source code and 
electronic online documentation, 
WinSCSI-32 is the ideal choice for all 
your SCSI programming needs. For 
Windows 95 and Windows NT Royalty-free. 



Paradise No. 
SEGWSBB-FT 

$175 


Spread v2,5 

by ForPoint Technologies 
A complete spreadsheet control 
for most environments that 
support a VBX, OLE control, or 
DLL Use as a spreadsheet to 
obtain variable lines of data or 
display tables of information. 

Data-aware—connect to 
databases with the Access Engine 
and ODBC, includes over 250 
properties and our improved 
Spread Designer. Formulas, sorting, 
and full-print support too, 



Paradise No, 
FASVX31 -FT 

$229 


Order online 24 hours a day, every day at tvnw.pparadise.com 

































































Available at the best prices from 

Programmer's Paradise 

^ Co-sponsors of Microsoft Developer Days 




On March 19th 

Mfemsoft 
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Win Help Office" 

by Blue Sky® Software 
WinHelp Office includes 
everything you need to 
quickly and easily create 
professional Help systems 
for Windows 3.1, Windows 
95, Windows NT 3.51, and 

Windows NT 4.0; the new HTML-based Help; printed documen¬ 
tation; and intra net/Internet Websites—all in one box! Win He Ip 
Office is power-packed with the award-winning Ro bo HELP, 
Mastenng WinHelp, WinHelp Video Kit, WinHelp Tool Kit, 
WinHelp HyperViewer, and Moving to HTML Kit. 

Paradise No. 
BSWOF8B-FT 


RoboHELP* 

by Blue 5ky fl Software 
The award-winning Ro bo HELP 4 is the 
fastest and easiest way to create Help 
systems for Windows 3.1, Windows 95, 
Windows NT 3.51, and Windows NT 
4.D.; plus the new HTML-based Help; 
printed documentation; and 
intranet/lntemet Websites. Full support 
of ALL Windows Help features, plus 
RoboHELP gives you the power and 
ease of use of Microsoft Word. RoboHELP 
saves you time—it's fast. Best-seller! 



HELP 




Paradise No. 
BSRHFB8-FT 
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For more information visit 

www.pparadise.com 


Visual Developers 
Suite Deal 

by Visual Components 
The Visual Developers Suite Deal 
is better than ever. Now with four 
full OCX tools for developing great 
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for stunning charts, VisualWriter 
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Track Record " 
for Windows 

by Under Ware, Inc 
Track Record is the top-rated 
tool that tracks every aspect of your 
software development project bug 
reports; feature requests; releases; 
testers; and much more As Data 
Based Advisor noted, “Track Record 
is dearly the technology leader—the 
most flexible and sophisticated of the bug trackers." Designed 
for individuals and for workgroups sharing information on a 
network. New version 3.0 offers Integration 
with version control software, optional Paradise No, 

e-mail notification, summary reports and UWRTB31 -FT 

more, Check out this winner of Software C* r* fl 
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Codewright 4.0 

by Premia 
More powerful than ever 
with the new API Assistant! 
Prevents bugs before they 
happen; has Button Links to 
non-text files; and Direct 
Access version control 
interface. Multi-file search 
and replace, help topic 
scanner, file differencing and 
merging, are real time-savers. 



Tab Pro v2.0 

by FarPoint Technologies 
Add organized and professional 
user interfaces to your Windows 
applications without spending a lot 
of time and money. Tab Pro allows 
the quickest and most flexible 
presentation using any of the 
supplied styles—no matter what 
your design environment. Customize 
tabs and notebook pages using 
Tab Pro's 150 properties, 15 events, 
and 9 functions. 



Let the products featured on these 
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outstanding products featured in 
the Programmer's Paradise catalog— 
lead you to "greatness" in the 
software development world. And, 
take advantage of our outstanding 
service—personally guaranteed by 
our president, Roger Paradis! 

A Presidential 
Guarantee ... 

To place your order, call today and 
take advantage of our convenient 
quick 2-day delivery to any location 
in the continental U.S.! 

"If you're not happy, we're not 
happy! You have my personal 
guarantee that well provide 
you with outstanding products, 
support and service." 

—Roger Paradis 

President Si CEO 
Programmer's Paradise, Inc. 
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Advanced Error Detection" system 
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to constantly find thousands of bugs 
that ordinary memory-checking tools 
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and BoundsChecker supports the lat¬ 
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COM/OLE, ODBC, Internet APIs and more. 
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Studio 

by WexTech 
Systems, Inc 
Documentation Studio is an 
integrated suite of authoring 
tools and utilities that allows 
simultaneous creation of printed 
documents, Windows online 
Help, standard HTML pages and 
Microsoft HTML Help, all from a 
single source file. Documentation 
Studio includes Doc-To-Halp 2.1, 
Helpsite 1.5, Quicture 2.0, Smooth 
Scaling 2,0, Setup Wizard 2.0, Lotus 
Screen Cam and BookMaker Click Book 


Paradise No, 
WTD0C88-FT 
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Electronic Commerce 

Purdues Markus Kuhn kicked off the Sec¬ 
ond USE NIK Workshop on Electronic 
Commerce with a talk on smart card 
tamper-resistance (or lack thereof). Kuhn 
(whose paper, cowritten by Ross Ander¬ 
son, was selected as the conference s best 
paper) refuted any assumption of a smart 
card's security by demonstrating practi¬ 
cal techniques for tampering with com¬ 
mon smart cards. Other papers at Lhe 
conference included Openmarkets Daniel 
Geer on token-mediated certification, 
Stanford's Steven Ketdipel on a univer¬ 
sal payment API, Gain eg i e-Mel Ion's Dar¬ 
rell Kindred on automatic protocol check¬ 
ing, and Bell Labs’ Eraii Gabber on a 
distributed protocol for electronic com¬ 
merce. 

There were some very good higher- 
level talks as well., Attorney Benjamin 
Wright spoke on the legality of digital sig¬ 
natures, comparing and analyzing existing 
law. John du Pre Gaunir. the business ed¬ 
itor of Public Network Europe- and a re¬ 
searcher at the London School of Eco¬ 
nomics! discussed electronic commerce in 
a social context, describing how electron¬ 
ic commerce changed the very way we 
think about money, offering several in¬ 
teresting historical examples, UC Berke¬ 
ley Law Professor Pamela Samuelson, 
well-known for her work in intellectual- 
property law and as a legal columnist for 
Communications of the ACM, discussed 
inidleaual-property law’s effect on com¬ 
merce law, citing current legal cases as 
examples of the direction and implica¬ 
tions of current public policy. 

— Eugene Eric Kim 

PC to Mac 

Executor 2 from ARDI lets you run many 
Macintosh applications on a PC The sys¬ 
tem, which runs on Windows 3*1/95* 
OS/2 Warp, DOS, and Linux, was de¬ 
veloped using "clean-room"' techniques, 
and includes no Apple code. It can also 
read/write Macintosh-format floppy 
disks, CD-ROMs* and hard drives A free 
demonstration version is available on 
AUDI'S web site (http://www.ardLcom/). 

— Tim Kientzle 

Computers 
and the Law 

The ever-changing issues of server secu¬ 
rity, cryptography, trade secret prosecu¬ 
tion, and first amendment interpretation 


were hot: topics of discussion at the Sun 
User Group s Computers and the Law III 
symposium. 

Among the interesting computer law 
cases reviewed was a puzzling new 
precedent set regarding real-time infor¬ 
mation and the commercial appropria¬ 
tion of "fresh” news. Jim Hemphill of 
George, Donaldson & Ford L.L.R dis¬ 
cussed The National Basketball Associa¬ 
tion (NBA) th Sports leant Analysis and 
Tracking Systems Inc . (STATS) case, in 
which the NBA sued Motorola and STATS 
over die practice of distributing real-time 
basketball scores to subscribers via 
pagers. The federal courts ruled in favor 
of the NBA, determining that, though 
NBA scores and statistics could not be 
copyrighted, the NBA does own” real¬ 
time information about its games. Defin¬ 
ing freshness as a commercial property 
could introduce some Interesting new 
intellectual-property concerns. 

Another discussion of note was Sili¬ 
con Valley criminal defense attorney Tom 
Nolan's discourse on a recent amend¬ 
ment to California’s Uniform Trade Se¬ 
crets Act. The amendment broadens the 
state’s definition or a trade secret, po¬ 
tentially lifting some trade secret disputes 
from the civil arena and enabling district 
attorneys to prosecute them under crim¬ 
inal law, 

— Dei aire Blake 

Pass the Quarters 

You may think that managing a team of 
programmers is hard work, but to some 
people it's just a game. MCI Sysfemhouse 
and Thinking Tools have developed an 
"agent-bused simulation tod” (read “video 
game”) in which you play a bedeviled 
manager who must deal with cranky pro¬ 
grammers, uncooperative clients, and un- 
supportive upper-level management. With 
a $1495 price tag, it’s unlikely to outsell 
Sonic the Hedgehog, but the developers 
hope large companies will see it as a train¬ 
ing investment. 

-—Tim Kientzle 

E-mail Directory 

Later this year, both Pacific Bell and 
Nynex will begin allowing phone cus¬ 
tomers to include e-mail addresses and 
l?RLs with their white-pages phone- 
number listings. The service won't be 
free for Pac Bell customers, Prices are 
expected to tall in line with the fees cur- 


reni customers pay for adding, say. fax 
numbers to their listing — $5.00 setup and 
H5 cents a month. 

— Amy Wu 

MSN3 Alienates 
MSN Members 

Microsoft’s new, more public, online ser¬ 
vice, MSN2, lias drawn criticism From dis¬ 
illusioned users of the old Microsoft Net¬ 
work service. Grievances are being posted 
at a protest site called "The Official MSNot 
Hate Site” (http;/ www.geodties.vom/ 
SoHp/9120/), The protesters’ gripes range 
from alleged censorship (critical comments 
have reportedly lieen removed from M5N2 
bulletin boards by forum hosts at Mi¬ 
crosoft) as well as MSNZ’s heavy use of 
Acti veX graphics, which makes browsing 
a slow process for some users, 

—Deirdre Blake 

Smart Money 

When it comes to chips, the 125,000 at¬ 
tendees ai last fall’s Comdex in Las Vegas 
were apparently thinking ,l Pentium* or 
“PowerPC 11 instead of “roulette" or “black¬ 
jack/ 1 To the disgust of some casino op¬ 
erators, gambling was down during the 
First two days of the show. 

—Jonatha n Erickso n 

The Season of Sharing 

Microsoft topped all other US, companies 
in gift giving, donating $73.2 million in fis¬ 
cal year 1995, The bulk of the company's 
largess— $62,1 million—was in software 
donations. Considering the tax write-offs 
and chance to hook new customers with 
upgrades, you have to wonder where the 
philanthropy part comes in. 

— Monica Berg 

Virtual Prayers 

V i rtua 1 jeru sa 1 era (h ttp: / / v i rt u a 1. co. il/) 
has launched the Send-a-Prayer service 
by which visitors ro the site can e-mail 
prayers to the Holy Land, The staff at 
Virtual Jerusalem will prim out prayers 
on a daily basis and place them in cracks 
in the Kptet — the Western Wall. Placing 
prayers at the holy site is an age-old Jew¬ 
ish tradition and, according to Virtual 
Jerusalem, the practice "lends permanence 
to your prayer/ The site also Features news 
about the city, a calendar of events, and 
interviews with famous international Jew¬ 
ish personalities, 

— Deirdre Blake 
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The Next Generation of Imaging Technology for Developers" 


ImageGear™ 6.0 shifts your development schedule into 
warp drive by providing you with the most 
comprehensive, easiest to use image processing solution 
available* With suppon for over 45 file formats and an 
API featuring 200 plus functions, ImageGear is the 
toolkit that no developer should be without. 

Standard and Pro Gold™ versions allow you to purchase 
the level of performance and functionality you need. 
ImageGear offers the high speed display of both bitonal 
and full color images with functions like scale-to-gray, 
automatic aspect-ratio correction, panning window, 
magnify window* and much more. Advanced features 
like auto-deskew, sub-pixel display accuracy, rotate to 
any angle, and special effects add robust image 


processing to any application. ImageGeaPs new display 
technology is fast and easy to use and printing is more 
accurate than ever with new high-level functions. The 
TWAFN scanning interface with support for 32-bit 
drivers gives you complete control. GUI functions make 
integration quick and seamless, and multi-platform 
support provides a complete solution to portability 
issues. 

The AccuSoft Image Guarantee™ assures that your 
application will read every valid image. You can turn to 
us with confidence because we have over ten years of 
experience as the leader in quality image processing. So 
call the experts at AccuSoft, and step up to the next level 
in quality and performance with ImageGear* 


Visit our Website @ www.accusoft.com 
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Unit and 

Regression Testing 


Reducing bug counts isn't as 
hard as you think 

Adrian McCarthy 

W hile we were looking at an image generated by my 
ray tracer, my brother asked, “How do you know it's 
right? 31 The question sparked an interesting discussion 
on software testing. Until then, l had done only black¬ 
box testing: Create a scene and inspect the output for incon¬ 
sistencies, One bug in my ray tracer—a sign error in a vector 
cross-product function—eluded detection for nearly a year 
because the symmetries in my early test scenes caused the sign 
error to cancel itself. Even after detection, it took a long time 
to find the bug. It could have been detected easily (and the 
bug found and fixed more quickly) by testing the vector op¬ 
erations in isolation from the rest of the system. 

Of course, black-box system testing is an important step in mak¬ 
ing sure your program works, but it’s only one piece of the puzzle. 
Unit testing (testing a function, module, or object in isolation from 
the rest of die program) and regression testing (rerunning tests to de¬ 
tect unexpected changes in behavior) can dramatically reduce your 
bug counts. 

In his excellent book. Writing Solid Code (Microsoft Press, 
1993), Steve Maguire mentions unit testing, but he doesn’t give 
many details on how to set up such tests and use them. In 
this article, I describe how to build simple and effective unit 
tests and how to automate regression testing using make. 

Unit testing should not l>e a luxury accessible only to huge 
product teams w ith hordes of testers. In fact, unit and regres¬ 
sion testing make ii possible for individuals and small teams to 
outperform big companies that rely too heavily on black-box 
testing to ferret out bugs. 

Automating Unit Tests 

Suppose for each key object or module in your project, you 
wrote a small test program to test just that portion. That might 
sound like a lot of work, but, as you’ll see, it’s not. If each of 
these unit tests accepts sample data from standard input and 


Adrian is a software engineer far Intuit and can he contacted 
at adria n_mccarthy@intuit . com . 


sends the results to standard output, you can automate the tests 
using your favorite variety of make. 

Imagine implementing a C++ class for performing vector arith¬ 
metic in a file called VECTOR.CPP. A unit test TVECTOR.CPP 
file would have targets in the makefile, indicating its depen¬ 
dency on the module it tests; see Example 1(a). The unit test is 
driven by a data file called TVECTOR.IN and produces output 
that you capture in TVECTOILOUT, as in Example 1(b). To pull 
it all together, a pseudotarget generates output from all of your 
unit tests; see Example 1(c). 

As you add more units to your project, you build more unit- 
test programs and add the desired output file to the TESTOUTS 
list. You now have a way lo automatically test all parts of your 
program that have changed. 

Big deal, you tliink—those output files still have to be checked 
by hand to see if they're right. True, but only the first time. Af¬ 
ter that, you care only about the changes in behavior. Changes 
occur when you make a fix, when you make a global change, 
or when you enhance a unit test. In all of these cases, you need 
Only verify that the changes are appropriate. Example 2 adds 
an accept target, enhancing the regress target. 

If your unit tests have passed, you run make with the accept 
target. That makes reference copies (often called “canon files") 
of the test results. When you make changes in the future, the 
regress target will compare the new r test outputs with the canon 
files and list the differences in REGRESS, RPT. The regression 
report tells you immediately what changed* If the changes are 
correct, you simply accept them to make new reference copies* 
If not, you correct the problem and run the regression tests 
again. These makefile examples have been simplified for dis¬ 
cission. Listing One (listings begin on page 82) presents a more 
realistic example. 

Have you ever considered making a global change in a big 
project and felt some trepidation? Perhaps you've been build¬ 
ing and testing debug versions, loaded with assertion macros. 
The ship date is approaching, and it s time to disable die debug 
code. What if somebody accidentally put code with important 
side effects into an assertion? Maybe your team lias been slav¬ 
ing away, porting code to a new compiler, memory model, or 
operating system* Ar times like these, wouldn’t it be nice to 
type MAKE REGRESS and know in a few minutes which modules 
may have changed their behavior? 

Building Unit Tests 

Is it worth making a test program for each unit? Yes. The effort 
is small, since the test program can l>c simple. More important- 
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Iy, the process will make your code better and smooth your 
development by eliminating bugs earlier. 

What should a unit test do? That depends on the module lacing 
tested. Minimally, the test should thoroughly exercise the module, 
striving lor complete coverage. For example, to test die Victor class, 
an exerciser would call each of the class’s member functions with 
a List of vectors read from TVECFOR.1N (see listing Two). Fortu¬ 
nately, this simplistic approach is appropriate for many modules. 

Slightly more ambitious is a unit test that attempts to verily the 
requirements directly. For example, if you re testing a prepro¬ 
cessor that should strip comments and trailing spaces, then the 
checker would examine die output for comments and spaces 
that were missed. 

A sophisticated unit test mighL try to simulate a client. A simula¬ 
tor makes sense for units that maintain state information from call 
to call, as is typical with parsers and event-driven systems. In these 
types of modules, the order of die calls is significant. You on have 
the simulator generate random calls, but that Ls incompatible with 
our regression testing, since we require the output of a successful 
test to match the reference run. One approach Ls to have the sim¬ 
ulator use the same input-driven technique of the exerciser and 
have a separate program create die random data, A king, randomly 
generated sequence provides a good chance of uncovering 
sequence-dependent bugs while maintaining reproducibility. 

For particularly troublesome modules diat maintain state infor¬ 
mation and require intensive abuse to beat out the bugs, a coni’ 
bination simulator/checker might be die ticket. The simulator por¬ 
tion would simulate calls in a random order. Radier than outputting 
die results directly (and thereby making it impossible to compare 
to the canon files), die checker portion would verify the results 
and output a summary. Summaries of successful runs would al¬ 
ways match the canon file, but one from a failure would not. One 
disadvantage of the simulator/checker Ls the amount of effort re¬ 
quired to build it. In addition to writing code to simulate and check 
the module, you should add a facility to reproduce a run so diaL 
when a bug Ls uncovered, it can lie traced. Often this can be done 
by supplying the seed for your random-number generator 

Once you've decided which approach to take, you need to 
decide exactly what your test program is going to do. Make it 
data driven so you can easily add more tests. Don’t be afraid to 


let it produce reams and reams of output. Remember, you Ye 
only going to check it manually once. 

To decide which calls to make and what data to use, con¬ 
sider the following three tilings: 

* Your requirements list, 

* Hie module's public interface, 

* Your knowledge of lioundary cases. 

If your requirements specifically mention certain cases (like 
what to do if a buffer is too small), make sure your test module 
tries those special eases. If you don't have a formal requirements 
list, you still have a good idea of what the module Ls supposed 
to do. For a moment, try to forget what you know about the 
implementation and pretend you’re a client who only has access 
to the comments in the header File or other documentation. The 
goal Ls to ensure that the module works as advertised. 

Make sure you call every function in the public interface. For 
example, if you Ye testing a complex number object, make sure 
you test all of the operators like + and +=> Don’t assume that 
one works because the other does, even if you know you im¬ 
plemented one by calling the other. When you add a new func¬ 
tion to an existing module, make sure you expand the unit test 
to exercise it. The goal is to ensure coverage. 

Finally, think about how you implemented the module. What 
assumptions did you make? What are the buffer limits? Where are 
tlie lioundary cases? Test them by adding more test data to the in¬ 
put file. For my vector class. I made sure I had the zero vector, 
orthogonal unit vectors, vectors with lots of decimal places, nor¬ 
malized vectors, unnomialized vectors, and so on: see listing Three. 
Again, foe goal Ls to ensure coverage. 

How many cases should you handle? How do you know when 
your test is complete? You’ll never know for sure. When I write a 
new module, I work on foe unit test until 1 find at least a few r 
bugs. If your test passes the very first time, then you probably 
missed something. Stress it harder until you uncover a few bugs. 

Listing Two presents the unit test for a vector class, and List¬ 
ing Three shows the Input file that drives the test. The program 
itself is trivial, but by adding cases to the input data, I eventu¬ 
ally shook out about a dozen bugs. 









Tlie test for the vector class tries each sample vector with each 
of the unary operators (unitize, scale, negate, and so on), and 
it tests each binary operator with every pair of sample vectors. 
That creates a lot more tests, but that's the whole idea. 

Benefits of Regressive Unit Testing 

From the start, 1 was convinced that unit and regression testing 
were worthwhile, but I was surprised at how useful they have 
proven to be. These are not theoretical benefits, but real ad¬ 
vantages I observed almost immediately after implementing my 
first few unit tests. Unit and regression testing will: 

* Find bugs early. 

* Isolate bugs faster 

* Stop bugs from coming back. 

* Prevent global changes from creating surprises. 

* Validate interfaces. 

* Increase coverage, 

* Test error handling. 

* Debug smaller chunks, 

* Give you a deeper understanding of your code. 

If you’re still doubtful, consider writing just one unit test, per¬ 
haps with a module you already use or with the next one you 
write. While it’s useful to have unit tests for all the modules in 
your program, having one or two is better than none, especial¬ 
ly for the key modules* If it doesn’t seem to help much and you 
abandon die practice, at least leave die one you built in the make¬ 
file. One day it’ll catch something nasty and unexpected. 

Practical Suggestions 

Same people resist die idea of unit tests because it seems dial only 
toy modules can be tested in isolation. Usually, this just reflects a 
lack of creativity on die programmers part. If you have a non¬ 
trivial module, consider it a challenge to write its unit test. L riit 
tests can be written to simulate* asynchronous I/O events, user 
events, client requests, server responses, plain function calls, and 
just about anyUiing else required Lo test a module. After all, if the 
rest of your program can interface to a module, then you should 
lx- able to write a different program dial also connects, 

Some modules may seem too dependent on other modules to 
lie tested in isolation, Often, this occurs when there’s a pipeline 
of modules operating on data, ft might be awkward to test a 
parser without also calling the lexical analyzer, which calls die 
preprocessor, There are a couple of approaches you can try. 

One is to let each stage of the pipeline rely on the earlier 
stages, but to write a test for each stage. For example, you could 
have one unit test for the preprocessor, one for the lexical an¬ 
alyzer and preprocessor in combination, and a third for the erv 
lire pipeline. By using the same input and checking the outputs 
at each stage, you can isolate changes and bugs about as easi¬ 
ly as if you had tally independent tests. 

Another solution is to have the test module provide stub in¬ 
terfaces for the other dependencies. For example, the test pro¬ 
gram for the parser might include an interface equivalent to 
the lexical analyzer. The stub would simply provide a canned 


(a) 

TVECTOR*OBJ : 
TVECTOR.EXE 

• TVECTOR.CPP 
: TVECTOR,OBJ 

VECTOR.H 
VECTOR.OBJ 

(b) 

TVECTOR.OUT 

: TVECTOR.EXE 

TVECTOR.IH 


TVECTOR,EXE < TVECTOR.IH > TVECTOR.GUT 

(C) TESTOUTS = TVECTOR. OUT 

regress : $(TESTOUTS) 


Example 1: (a) A unit test called TVECTOR.CPP; (b) the unit 
test is driven by a data file; (c) output from unit tests. 


accept: 

del -*.re£ 
copy . out *•. ref. 
regress: ${ TESTOUTS ) 

echo "Regression Report Tr > REGRESS. RFT 
fc TVECTOR,RET TVECTOR.OUT » REGRESS.KPT 
... one for each unit test 


Example 2: Adding an accept target and enhancing the 
regress target. 

stream of tokens from the input file. Stubs also work with non- 
pipelined dependencies. 

If a module has so many dependencies that the unit test is 
difficult, dien it probably needs a unit test more than any other 
module. When there's that much complexity, it will have more 
bugs, and it'll be much easier lo find and repair them if you've 
got some scaffolding to help you get to the heart of the matter. 

When writing test programs, give a little thought to die out¬ 
put that will l>e captured and compared. Keep in mind that you’ll 
lie looking primarily at differences as reported by your favorite 
file-comparison program. Put enough information on a single 
output line Lo identify which case failed. Each output tine from 
the Vector exerciser shows the vector or vectors used, die oper¬ 
ator, and the resulting vector. In more abstract cases, this explicit 
detail might not be possible. An alternative is to refer to the line 
number in the input file that generated die current case. 

If you get serious about unit and regression testing, take the 
time to integrate them into your development environment. Your 
test programs, sample data, :md canon files should be kept in your 
source-control system. 'Hie ability to recreate tests from an earli¬ 
er version can help isolate changes dial led to elusive bugs. Es¬ 
tablish a naming convention for your tests. In my examples, I've 
simply prepended the module name with T (for Test). You might 
want to do something more sophisticated. If you have automated 
weekly or nightly builds of your system, expand them to run the 
unit Lests as well* A fancy system might even said e-mail to team 
leads if the regression tests indicate changes in liehavior. 

In my makefile examples, the accept target cavalierly replaces 
the current canon files with the current test results. This may be 
too accident prone for a large project. There are several alterna¬ 
tive ways to handle it, 

* Write a batch file that asks for confirmation. 

■ I lave die accept target make sure die current references are re- 
coverable by checking them into your source-control system. 

* Create makefile rules to check in test results individually. 

The best solution might be a combination of these approaches* 

Conclusion 

Fortunately, few programmers write an entire application before 
testing it at all Gammon practice is Lo write a bare skeleton and 
then fill in the pieces, testing along die way. Bui die first work¬ 
ing skeleton may require bringing together quite a few untested 
pieces before having anything that runs. Hie program-In-piogress 
generally isn’t die best test lied for new components, nor does it 
provide for automation of ongoing testing. Nonetheless, common 
practice survives because the perceived value of better strategies 
doesn't justify perceived cost. My experiences, however, indicate 
that unit testing has more benefits than one might think, and au¬ 
tomated regression testing of these units is easy to implement with 
existing tools, 

DDJ 

(listings begin on page 82 .) 
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A Debug/Trace Tool 


Powerful debugging 
with minimal tools 


Rainer Storn 

W hen it comes to debugging, pro¬ 
grammers usually fall into one of 
two camps: those who regard 
printJO as old-fashioned and be¬ 
lieve that modern source-level debuggers 
do everything necessary, and those who 
claim that source-level debuggers often 
don't. For instance, the former argue that 
notiiing can replace features such as step¬ 
ping forward and backward and the op¬ 
tion of looking at arbitrary variables at 
any time. The latter, however, claim that 
source-level debuggers often don’t let 
you set the granularity or skip break¬ 
points for a certain amount of times, that 
few offer CRC capabilities, that regres¬ 
sion tests require code instrumentation 
anyway, and that they are tired of setting 
each breakpoint anew once they’ve 
changed and recompiled their sources, 
"lire debug/trace tool I present in this 
article provides help for the second 
camp, and maybe even for the first 
one—if you are willing to exploit the 
advantages of both strategies. The tool 
is also appropriate when you don't have 
a powerful debugger available, or when 
you need trace functionality built into 
your code to support error-spotting at 
the clienL site. 


Rainer, who studied at the University of 
Stuttgart, Germany, is a postdoctoral fel¬ 
low at the International Computer Science 
Institute and can he contacted at storn @ 
icsi.berkeiey.edu or miner.storn@zfe 
siemens.de. 


This tool has its roots in the debugger 
developed by Robert Ward in Debugging 
CTQue, 1986). However, 1 have changed 
and extended it significantly. Although my 
tool uses Borland C++ 3-1 and runs on a 
486 PC, its pans are independent of the 
80x86 family’s memory organization and 
have run on a SPARC 5 under SunOS 4.1.3. 
The complete source code, sample data, 
and executables are provided electroni¬ 
cally; see ‘ Availability," page 3- 



The Debug/Trace Taol 

The dbg() function is central to the func¬ 
tionality of the debug/trace tool I present 
here. For practical purposes, dbg() con¬ 
stitutes an extended printf() ■ it is de¬ 
clared as in Example 1(a) and can be 
used as in Example 1(b). The first vari¬ 
able in dhg( X arbitrarily chosen to be 
7jstp, is a label and w ill be used by the 
tool like a breakpoint address or a trace 
identifier. The second dbg() variable, ar¬ 
bitrarily chosen to be 2, is a trace level 
and will be used to enable or disable the 
printing part of a dbg() statement, de¬ 
pending on the trace level activated by 
the tool. If you choose the trace level to 
be 2, then all dbg() statements that ex¬ 


hibit die levels 0, 1, or 2 wall perform the 
appropriate printout, w'hich is defined by 
the subsequent parameters. These pa¬ 
rameters follow the syntax used in a reg¬ 
ular printfO statement. 

The Command Interpreter 

Once you've started to run your program, 
the tool will stan to display DBG» in or¬ 
der to give you access to the tool's com¬ 
mand interpreter. The commands that you 
have access to are grouped into basic and 
advanced commands. In many cases, die 
basic commands suffice to spot the enor 
you are looking for. For more intricate 
bugs, however, you can resort to the more 
advanced commands. 

Bosk Commands 

From a programmer's point of view, die 
basic commands allow r for an enhanced 
pn>z(/facility with the option of swildiing 
the printf function on and off as well as 
stopping die execution at predefined stop 
points (breakpoints). A major asset is the 
ability to store and load the breakpoint 
configuration. 

The question mark (?) activates the help 
comment, which will display all commands 
of the interpreter along with brief de¬ 
scriptions of their use. 

The command STOP n pattern defines 
stop pattern n, where n=l, 2,.,., 10, which 
indicates a breakpoint. If the tool detects 
a dbg() statement with diis pattern in the 
label part of dhg() t it will stop execution 
and prompt DBG ». For Example 1(b), 
an appropriate command to reach the stop 
point would be STOP 7 7_stpl Note that 
the parameters after STOP must be sepa¬ 
rated with blanks and that die parameter 
pattern does not store spaces; the label 
* Ijstpl r (note die trailing space) will not 
trigger the dbg() function, as it cannot be 
represented properly by pattern , Always 
finish a stop label in dbg() with a non¬ 
whitespace character, 
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(continued from page 22) 

For pattern, you can also use the wild¬ 
cards “?" and H *’\ For example, the pat- 
tern 7_s* will match all labels in your pro¬ 
gram starting with 7js. The pattern 7_stp?7 
will match any label starting with 7_stp 
and having two additional arbitrary char¬ 
acters. Again, only the stop numbers 1 
through 10 are available. However, this 
can be extended easily in the source code 
if you need more than ten stop points. 

The GO command resumes execution 
and returns control to the program being 
tested. The program will run until the nexL 
stop point Is encountered. 

The command TRACE n pattern de¬ 
fines the trace pattern, where nr 1, 
2 t ., ,,10. Tf the tool detects a dhg() state¬ 
ment with this pattern, it will execute the 
dbg() statement; that Ls, it will print the 
desired message if tire trace level allows 
it to. For Example 1(b), an appropriate 
command to achieve printout would be 
TRACE 1 7_stph Tlie treatment of the pa¬ 
rameters is the same as described for 
STOP. As with the stop command, only 
the trace numbers 1 through 10 are avail¬ 
able. However, this can be extended if 
you need more than ten trace points. As 
a default, all trace labels are enabled, and 
the debugger acts as if TRACE 1 * were 
used at initialization. 

The command LEVEL n specifies trace lev¬ 
el n and suppresses all enabled trace points 
with a level parameter greater than n. 

The STAT command displays the status 
of the debug/trace Lool. The status com¬ 
prises the activated stop and trace points, 
the trace level, anti some advanced com¬ 
mand parameters, 

SAVE filename saves die status of die 
debug/trace tool in the file specified by 
filename. If just the command SAVE is 
used, STAT DAT will be used as the de¬ 
fault Filename. The saw feature is helpful 
if multiple runs of a program with the 
same trace, stops points, and the like are 
required, especially if the program code 
has been changed between mns. You can 
use this command not only for debugging, 
but also for regression testing, provided 
that your dbg() statements remain in the 
code. SAVE is used together with LOAD. 


(a) void dbg (char *stop, int 

level ,char ormat, T .*) ; 

(bj mean = 0; 

for (j - mini j < max; j++) 

[ 

mean = mean + array [j]; 

dbg("7_stp tf , 2. 

"\n mean - /f " , mean) ; 

) 

mean = mean / (max - min + 1); 


Example I: (a) Declaring dbg(); 
(b) using r&edbgQ function. 


The LOAD filename command loads 
the status of die debug/trace tool from die 
file specified by filename. If just the com¬ 
mand LOAD is used, STATDAT will be 
used as the default filename. 

Finally, the command QUIT quits the 
debug/trace tool and finishes die program. 

Advanced Commands 

Advanced commands extend the basic 
commands. For instance, you can skip the 
stop and trace points, store the trace out¬ 
put, and gain insight into the physical 
memory by using a dump and checksum 
facility. 


It sometimes helps 
to think of the code 
as divided into 
logical sections 


The GRAN n command sets the trace 
granularity to n so that only every mb 
dbg() call, the level variable of which is 
smaller or equal to the current trace lev¬ 
el, will be printed. The argument n must 
always lie greater than zero. GRAN n can 
be helpful when you know that a bug in¬ 
volves a certain variable. The variable ends 
tip with a wrong value, but you are un¬ 
certain where or when the variable ac¬ 
quired that value. In such a case, you may 
decide to examine every thousandth ref¬ 
erence to die suspect variable. Then, with¬ 
in die 1000 references that surround the 
error, you examine every hundredth ref¬ 
erence, Finally, within the 100 references 
that surround die error, every reference is 
examined. This is referred to as an “ad¬ 
justment In granularity/ 

The command SSKIP n is the stop- 
point skip command Lo skip n stop 
points. For example, by entering SSKIP 
3: you tell the debug/trace tool to skip 
the next three activated stop points. The 
SSKIP command is particularly useful 
when you don't want to cancel die stop 
points (because you want to use them all 
again); just skip some in ihe present run 
to concentrate on a specific part of your 
program. A good example of this involves 
loops, where you just want to examine 
their beginning and end. 


For instance, once you've examined the 
first output for u=0 and v=0 in Example 
2, you might want to skip die next 34 stop 
points by entering SSKIP 3 4 and resume 
witii the last one. As an aside, once you’ve 
activated tracing on label J_initL the out¬ 
put portion of the dbg() statement will al¬ 
ways lie executed, which means that 34 
outputs are running over your screen. If 
you don’t like tills, you should first switch 
off tracing by entering LEVEL 1 before you 
type GO, thus changing the trace level. Al¬ 
ternatively, you can use the TSKIP n com¬ 
mand, which is analogous to SSKIP n but 
has influence on die activated trace points. 

The command TRCMD c filename spec¬ 
ifies the trace mode, which selects either 
die console, the file specified by filename, 
or both as the output device. If no file¬ 
name is specified, TRACE.DAT is the de¬ 
fault. The options for c are: c, tracing to 
console only; f, tracing to file only; and a, 
tracing to console as well as file. The de¬ 
fault setting for c is “console only.” This 
is used every' time die debugger is start¬ 
ed Lind cannot be influenced by die LOAD 
command. 

WATCH n addr defines a memory ad¬ 
dress that will be watched and assigns this 
address the identification number n (up 
to now, only 1 T 2, and 3 have been im¬ 
plemented), Watch addresses are exam¬ 
ined automatically at certain dbg() calls 
according to the watch mode selected. 
Whenever an examination reveals that the 
contents of a watch address have changed, 
a stop point is forced. The syntax of addr 
depends on the memory model used for 
80x86 processors. For the tiny and small 
model, addr is a four-digit hexadecimal 
number. For the medium, compact, large, 
and huge models, addr consists of two 
four-digit hexadecimal numbers separat¬ 
ed by a colon. 

The command WATMD c specifies 
which dhgf) calls trigger automatic watch 
examination. The options, specified by a 
single character, are: o, all watches off (the 
default); s, examine at stop points only; 
t, examine at trace points only; and a, ex¬ 
amine at ail occurrences of dhg(). 

DUMP ten stall prints, in hexadecimal 
and ASCII format, the rc-byte block of 
memory beginning at address start. The 
syntax of start depends on the memory 
model used for 80x86 processors (see 
WATCH n addr). If the parameters ten 
and start are not specified (that is, only 
DUMP is used), the dump is performed 
using the previous values for ten and 
start, if any. 

The CRCK ten start command computes 
a cyclic redundancy check over the n- 
byte block of memory, beginning at start. 
The notation;]I remarks for ten and start 
are the same as for DUMP ten start. 
Checksums are a powerful technique for 
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(continued from page 24) 
detecting errant pointers that write on 
code. The user simply recomputes the 
checksum at regular intervals during the 
program's execution. If the checksum at 
one computation differs from the previ¬ 
ous computation, an intervening pointer 


for(u=0;u<6;u++) 

C 

for(v=0;v<6:v+-^) 
dbgf"i-initl", 2, 

M/d] [/d] = 

/d ri , u i v i w [u] Ev]): 

) 


Example 2; You can use the SSKIP 
command to skip the next 34 stop points. 


(a) linclude <stdarg + h> 
extern void dbg_init(void); 
extern void dbg(char 4, int, 

char *, ...); 

(b) void main (void) 

t 

int i, j: 
float x h y , z; 
dbg^init(); 

] 


Example J,' (a) Necessary' debug state¬ 
ments in the program you want to debug; 
(h) initializing the debug/trace tool. 


reference must have modified the code. 
If the parameters len and start are not 
specified (that is, only CRCK is used), the 
checksum is computed using the previ¬ 
ous values for len and start, if any. 

Additional Advanced Commands 

Some commands are available only in 
basic form because their implementations 
depend either on the memory model, 
compiler, or application program. IVe im¬ 
plemented these commands using the 
DOS small memory model However, since 
the source code of the debugging facility 
is available and documented, you can 
adapt the appropriate functions to fit your 
environment. 

STACK gives a stack dump of all stack 
locations with return addresses (frame- 
pointer chain). 

The command STCMD c specifies which 
dhg() calls trigger automatic stack exam- 
[nation. The options, specified by a sin¬ 
gle character, are: o, stack examination off 
(the default); s, examine only at stop 
points; t T examine only at trace points; and 
a, examine at all occurrences of dbg(). 

The LOCAL n command prints the lo¬ 
cal variables and parameters associated 
with the last n stack frames. 

SNAP n invokes one of three user- 
defined snapshot functions 0?=1,2,3)> 


Snapshots usually are defined separately 
for each program tested and are used to 
dump global or local variables accessible 
via a globally known pointer. 

Using the Debug/Trace Tool 

To use the debug/trace tool, you must in¬ 
clude dbg() statements in your code 
wherever necessary. You must also in¬ 
clude the statements in Example 3(a) in 
the program you want to debug. Next, 
you must place the function dbgJnitO 
at the beginning of your program to ini¬ 
tialize the tool, as in Example 3(b). Final¬ 
ly, you need to link the object file of the 
tool to the object file of the program un¬ 
der test. You can then run the program to 
t>e tested. 

When instrumenting your program, it 
sometimes helps to think of the code as di¬ 
vided into logical sections. In the first sec¬ 
tion, all labels mighL start with 1_, in the 
second, all labels start with and so on. 
In each section, the trace level can be used 
to distinguish the nesting level, starting with 
level 1, Level 0 should be reserved so that 
tracing can be switched off if necessary. 
Listing One (listing begins on page 84) is 
C code that illustrates this approach. 

DPJ 

(Listing begins on page $4,) 
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DBTools*h++ sets the pace by delivering performance 
that will satisfy even the DBToois.h++ users who measure 
their data sets in terabytes, and their transactions in mil¬ 
lions per day. Regardless of the size of your database, you 
need C++ access without a lot of overhead. DBTools.b++ 
gives you the power and ease of use you want, and the 
performance you demand. 

POWERFUL NEW FEATURES 

DBTpols,h++ includes support for asynchronous database 
access. It also supports binding of variables to SQL state¬ 
ments to streamline processing of large data sets, and 
includes fully implemented multithreading capabilities 
(when supported by the compiler and database client 
library). 

You Choose the Database, 
DBTOOLS.H++ DELIVERS THE C++ ACCESS 

DBToois.h++ encapsulates SQL 92 DML functionality 
and delivers native access to Oracle, Sybase, Informix, 
Microsoft SQL Server, and Ingres databases, plus general 
connectivity through ODBC. Source code is available on 
Windows, Unix, and OS/2 platforms. 

CUT DBTOOLS.H + + DEVELOPMENT TIME 
BY 30% OR MORE! 

DBFactory supercharges DBTook.h++ by automatically 
creating portable C++ objects that represent your data¬ 
base schema information. You control code generation 
through a poinl-and-click interface. Choose die elements 
you want to represent in your application, and DBFactory 
does the rest, creating .h files, *cpp files, and documenta¬ 
tion for each generated class. DBFactory tracks your 
changes, so you can modify generated code today, regen¬ 
erate to capture database changes tomorrow, and retain 
your modifications, 

With DBTookh++ and DBFactory, you’ll write 
cleaner database applications, realize shorter develop¬ 
ment cycles, and reduce your maintenance costs, all 
without disruptive changes to your IS environment. 






On a Solid Foundation 


Tools.h++ 

1 Inter.Net.h++ 

A World-Class Foundation 1 

■ Simplifies Network Programming 

; t | Standard C++ Library | 

Nct.h++ 


Build a solid foundation for your application 
with Tools.h++. Tools.h++ is an internation¬ 
alized C++ foundation class library packed 
with over 1 20 reusable classes including sets, 
bags, sorted collections, strings, dates and 
Limes, extensible virtual streams for persis¬ 
tence, and more. Tools. h++ 7.0 adds endian 
streams j non-intrusive persistence, enhanced 
regular expressions, and a higher-level 
interface to die Standard C++ Library. 

Rogue Wave's Standard C++ Library truly 
is the standard. Our role, as a member of the 
ANSI/ISO committee allowed us to create a 
pure, conforming implementation of the new 
standard. Slant lard C++ Library includes 
updated data structure and algorithm classes, 
plus string, numeric limits, and complex 
classes, and allocators. 


Threads.h++ 

Portable Multithreading 


Threads. h++ provides everything you need 
to add multithreading to existing applications 
or to write new multithreaded applications 
from scratch, including thread creation 
and control classes, thread Synchronization 
mechanisms, and inter-thread communica¬ 
tion features. 

Use the Threads,h++ thread creation and 
control classes to create, interrupt, join with, 
and cancel threads; monitor their execution 
state; adjust their priority; and more! Use the 
library's complete set of synchronization 
classes to control access To shared resources. 
Represent the future result of an operation 
with the library^ lOU feature. 

Plus, when you use the Threads.h++ 
pi at form-independent programming model, 
you can write your multithreaded applica¬ 
tion once, then recompile to run in other 
environments, 


With the explosive growth in popularity of 
the Internet and corporate Intranets, more 
and more developers are incorporating 
TCP/IP-based protocols into a wide variety 
of applications. lnter.Net.h++ offers C++ 
classes for the most popular Internet proto¬ 
cols, with a simple object-oriented interface. 
Plus, the classes are multithread hot! It 
includes support for client-side implementa¬ 
tions of FTP, HTTP, POP3 and SMTP, and 
works in combination with Nel.h++ to 
improve your productivity and reduce the 
lines of code you write for your network 
applications. And, of course t the same code is 
portable betw een Windows and Unix! 

Net.h++ is a powerful 
C++ class library for 
developing network 
applications. It provides 
an easy-to-use object- 
oriented interface to 
TCP/IP, offering you a 
clean, maintainable way 
to write code for 
client/server and peer-to-peer communica¬ 
tions. You can w rite directly Co Net.h++ % 
portable C++ sockets abstraction, or you can 
use a higher level of abstraction that allow s 
you to stream your data over a TCP/IP net¬ 
work using C++ iostream classes or Rogue 
Wave's virtual streams classes. The virtual 
streams classes provide a powerful persis¬ 
tence mechanism for Net.h++ applications. 
Net.h++ code is portable to all major Win¬ 
dows and Unix platforms, and to OS/2. 



^pp 

zApp Developer’s Suite 3.0 

contains so many features and so much func¬ 
tionality that programming portable C+ + 
GUIs is simpler than ever! The zApp 
Factory visual builder cuts your develop¬ 
ment lime in hall by allowing you to drag- 
and-drop predefined components from the 
tool palette to create your user interface, 
test the interface without compiling a single 
line of code, then generate fully commented 
C++ code wiLli the click of a button . 

Functionality End users Demand 

The classes that ship with zApp Developer's 
Suite range from high-level controls such as 
tabbed dialogs and hierarchical list boxes to 
a highly sophisticated spreadsheet-like table 
object. They also include basic functionality 
such as size, positioning and drawing classes, 
as well as powerful geometry and clipboard 
classes. 

All the zHelp You Need 

Add context-sensitive help to your appli¬ 
cations in a snap with zHelp, our portable 
help library. zHelp covers all the bases from a 
single set of HTML source files. It provides 
full hypertext navigation of multiple help 
pages, including graphical links, and 
an automatic search engine. In 
addition to using preformatted 
text, you can control the look of 
your help pages with multiple fonts, 
italics, and bullets. 

Industrial-Strength Foundation 

Best of all, version 3.0 of zApp Developer’s 
Suite is integrated with Toc>Js.h++, the C++ 
foundation class library relied upon hv tens 
of thousands of developers worldwide. 



Professional Services 


On-site training helps you develop your 
C++ expertise in a variety of topics, ranging 
from code design to specific instruction 
about Rogue Wave products. Our mentoring 
services take this transfer of expertise a step 
further, as we work directly with your devel¬ 
opment staff on projects. 
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Java GUI Testing 


Automated testing 
is as problematic 
as it is essential 

Alan Walworth 

G raphical user interlaces may he a 
dream for users, but they can be a 
nightmare for testers. As Java de¬ 
velopment takes off, so does the 
need to test GUI applications written in 
java. The newness of Java and Java- 
oriented testing tools makes this a chal¬ 
lenge, however. This is as true for devel¬ 
opment groups within Sun (such as die 
Workshop Products group, of which I’m 
a part), as for third-party developers. In 
this article, III examine Java GUI testing 
issues in general, then present some of 
the solutions we've adopted for tesdng 
Java GUI software. 

Automated Testing 

Though automated test suites can never en¬ 
tirely eliminate the need tor manual testing, 
they are invaluable as an efficient way of: 

* Detecting new problems quickly. 

• Making sure old problems remain fixed, 
• Verifying that a package satisfies funda¬ 
mental quality criteria prior to shipment. 

For applications with command-line in¬ 
terfaces, test automation can, as a rule, he 
readily accomplished with the help of I/O 
redirection, which feeds the application 
input from a Hie (rather than from the key¬ 
board) and sends the application’s output 


Alan, a software-quality engineer for 
Sun s Workshop Products unit\ can be con¬ 
tacted at alan.tmlworth@Eng.Sun.COM. 


to one or more files (rather than to the 
screen). With a scripting language Lhat 
makes it easy to perform initial setup, you 
can also run individual tests, and evalu¬ 
ate and report results. 

Automated GUI testing, on the other 
hand, is as problematic as it is essential 
Special tools are needed to simulate in¬ 
put, which ordinarily comes in through 
the GUI. Similarly, graphical output can 



be captured and analyzed only with 
special-purpose tools. For Java GUI 
applications, the need to use special test¬ 
ing tools is unusually problematic — be¬ 
cause of Java’s newness, the necessary 
tods are just beginning to appear. 

Since a major attraction of java is its 
platform independence, testing Java ap¬ 
plications (or applets) tends to require test¬ 
ing on multiple platforms. On die face of 
it t therefore, the tools need to w T ork on all 
targeted platforms. A colleague facetious¬ 
ly suggested that there is really no need 
for multi platform tools for Java testing, be¬ 
cause a Java program verified to work 
properly on one platform Is guaranteed 
to work Identically on all others. "Write 
once, run anywhere” is indeed one of the 
promises of java, but remember that java 


Is still a relatively immature language and 
is by no means perfect. Early versions of 
the AWT (Abstract Window Toolkit), in 
particular, behave differently (and at times 
quite improperly) depending on the op¬ 
erating system used. Presumably, these 
problems w'ill be significantly diminished 
in JDK 1.1, but for die foreseeable future, 
serious testing of Java applications will re¬ 
quire testing on all major platforms. 

There are two basic ways of creating 
the required sort of multi platform Java GUI 
test tool The first option, adding Java ca¬ 
pability to a preexisting non-Java tool, has 
the advantage of inheriting die strengths 
of die preexisting tod. On the other hand, 
such a tool is not guaranteed to run on 
all platforms. The second option, of 
course, is to create a Java-based tool from 
scratch that can be expected to migrate 
automatically to new' platfomis along with 
the application being tested. In the short 
run, however, the new software is likely 
to lack refinement. Our search for test-de¬ 
velopment tools turned up one candidate 
of each kind—Segue’s QA Partner and 
SunTest's JavaSTAR, 

QA Partner 

The most recent version of Segue’s QA 
Partner fhttp://www.segue.com/), a w r ell- 
established GUI testing tool running on 
UNIX, Windows, OS/2 and Macintosh, in¬ 
corporates a “Web-aware” capability 
which, among other merits, provides the 
ability to test Java applets and applica¬ 
tions. Given its non-Java roots, QA Part¬ 
ner naturally achieves this capability not 
by interacting w p ith AWT components di¬ 
rectly, but by interacting with associated 
native GUI components on the various 
platforms, such as Motif widgets on UNIX 
and Windows controls on Windows 95/NT. 

For Java testing, this strategy has pros 
anti cons that need to be considered ac¬ 
cording to your needs. Basing testing on 
native components is attractive for test¬ 
ing applets running under a browser such 
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Leave it lo the creators of the Java™ platform to give you Java™ Workshop™ The only way to 
create and test Internet applications where they’ll run, on the Internet. Making it easier and 
faster to develop Java applications. Plus it's written in Java* so you can develop on Solaris™ O/S. Windows 95. 


Windows NT and soon on the Mac OS. $99 gets you Java Workshop and all the upgrades for a year* To find oui 
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(continued from page 30) 
as Netscape Navigator, which itself uses 
the native GUI. With a test tool that uses 
native components, Netscape Navigator 
events can be captured, and Navigator in¬ 
terface properties tested, along with the 
events and interface properties of the java 
applet (or more precisely, along with 
those of tlie native implementation of the 
applet's GUI elements). 

On the other hand, the tool is not di¬ 
rectly aware of the Java components, 
specifically at the AWT level. Therefore 
trouble may result from inability to rec¬ 
ognize Java ( AWT) component events anti 
properties, or from inability of a single test 
script to cope with the differing native 
manifestations of the same Java compo¬ 
nent from one platform to another 

For example, the JDK L0,2 AWT File- 
Dialog has different native implementa¬ 
tions on Windows and UNIX, each con¬ 
taining native components (such as text 
fields) that do not match up with corre¬ 
sponding components at the AWT level. 
Tlie AWT interface allows interaction with 
tiie FileDialog as a whole, rather than with 
particular items (such as native text fields) 
within the FileDialog implementation. 

Thus, if a tool that is aware of only the 
native components is used to record in¬ 
teraction with a FileDialog on UNIX, the 
resulting test script will not l>c able to han¬ 
dle the corresponding interaction on Win¬ 
dows, since die Windows components will 
differ Consequently, at least the FileDialog 
interaction wifi have to be rerecorded. For 
a tool that operates at the AWT level, on 
die other hand, die details of the native 
components from which the FileDialog is 
constructed are ignored, so the differences 
in nadve implementations will not prevent 
a test snipt recorded on one platfomi from 
playing back unaltered on another 

Because we primarily wanted to lest 
applications such as Java Workshop which 
are written entirely in Java, the ability to 
handle Netscape Navigator or other na¬ 
tive browser events was not a significant 
benefit in our situation. (Though Java 
Workshop is browser based, it uses an 
adaptation of the Hotjuva browser, which 
is written in Java,) Also, in our particular 
case, QA Partner's lack of Macintosh Java 
support was a hindrance, (Segue has ex¬ 
pressed interest in implementing Macin¬ 
tosh Java capabilities if there is sufficient 
demand.) 

JovaSTAR 

JavaSTAR is a Java GUI test tool from 
SunTest, a Sun unit that develops Java test¬ 
ing tools; see http ;//www.suntest, com/, As 
a purely Java-oriented tool, it is aware of 
AWT components, recognizing diem die 
same way regardless of platform. Tire cor¬ 
responding drawback, of course, is dial 


JavaSTAR is unaware of non-Java com¬ 
ponents and dius cannot be used to di- 
recdy control or test diem. Again, this was 
not a problem for us because our target 
application (Java Workshop) was written 
entirely in Java. 

However, java Workshop's installation 
and startup are not Java based; on Solaris, 
for instance, installation uses tar, Windows 
installation employs Install Shield. Thus 
JavaSTAR cannot help us test Java Work- 
Shop installation, except indirectly by de¬ 
termining whether Java Workshop works 

Testing Java 
applications (or 
applets) tends to 
require testing on 
multiple platforms 


after il has been installed. Since installa¬ 
tion Is relatively straightforward, this lim¬ 
itation was not a serious concern. 

Platform-specific startup mechanisms 
were a more serious issue. On UNIX, for 
example, Java Workshop uses a wrapper 
script to arrange die proper execution en¬ 
vironment; on Windows, it uses an exe¬ 
cutable ( jws.exe). Though details of gel¬ 
ling die environment right—setting paths 
and the like—tend to differ from one plat¬ 
form to another, you may wonder why 
the housekeeping cannot, nevertheless, 
be done with java, since a Java program 
can determine which operating system it 
is running on (with SystemgetProperty- 
Cbs.mme U) and should therefore lie able 
to tailor the setup accordingly. However, 
there would still be a residual problem of 
in vexation complexity. On Windows, for 
instance, users should not be forced to 
type a relatively complicated command 
such as java sun.jws.Main”; plain ,l jws r ’ is 
obviously preferable. Although platform- 
dependent configuration can be handled 
by Java, existence of at least a minimal 
wrapper script or executable is. at least 
for the time Ixing, unavoidable. Given that 
there must be a wrapper in any event, it 
is hard to make a compelling case that the 
tool must handle configuration elsewhere. 
Though we lacked a way to involve 
startup wrappers in automated test runs, 
we determined that we could neverthe¬ 
less keep JavaSTAR tests fully platform in¬ 
dependent by reimplementing the neces¬ 


sary' path setting operations in a Java class 
that could be called from the test harness. 

Another factor in favor of JavaSTAR was 
that, because it was written in Java, we 
should be able to use it on any platform 
on which Java Workshop might be sup¬ 
ported in the future. To be sure, there will 
be new startup issues to resolve in mov¬ 
ing to additional platforms, but these prob¬ 
lems shouldn’t be insurmountable. 

On the other hand, an obvious draw¬ 
back of JavaSTAR (when we began eval¬ 
uating it in August, 1996) was that it was 
new, and in many respects, rudimentary. 
For example, paths to golden directories 
were generated using forward slashes, 
with die consequence that they worked 
only on UNIX, not on Windows. Howev¬ 
er, such glitches were fixed with succes¬ 
sive releases. 

Test Harnesses 

Being able to construct a GUI test that 
runs without human intervention is a big 
step. I tow ever, automated testing requires 
running collections of tests, with conve¬ 
nient mechanisms for controlling the set 
of tests to be run and for controlling the 
conditions under which the tests are run 
(such as the set of binaries used). Con¬ 
sequently, a test “harness” is required to 
manage the tests, I won’t go into the ins 
and outs of test harnesses. Instead, 1 re¬ 
fer you to a minima] harness 1 wrote that 
provides basic functionality (available 
electronically; see "Availability,” page 3). 
This Java test harness is a work-in- 
progress and is provided for illustrative 
purposes only. 

Ha ving decided to use JavaSTAR to con¬ 
struct our tests, our next challenge was to 
choose a 'Tear harness. The only one we 
found for running java tests was JavaTest 
from JavaSoft with its Java API test suite 
(also known as the Java Compatibility Kit, 
or JCK) harness. At the outset, JavaTest 
presented two advantages. First, it had 
been in use for some time and thus was 
relatively mature. Second, we had already 
used it as a framework for a non-GUI 
benchmark test suite we had constructed, 
and we wanted to avoid a proliferation of 
harnesses that would complicate the job 
of running any arbitrary subset of our test 
suites. Another advantage was that Java¬ 
Test was written in Java and thus could 
be expected to run on all platforms. 

However, during our initial review in 
August 1996, JavaTest was deficient in its 
ability to manage GUI tests. For instance, 
it was designed to manage suites of API 
tests, a task that differs in important re¬ 
spects from managing GUI test suites. A 
typical API test is a short program, per¬ 
haps 20 lines, written with the specific aim 
of testing a particular Aid feature, Java¬ 
Test assumes that the test developer has 
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(continued from page 32) 
total control over the test program, and 
requires that the test program interface with 
the harness in specified ways, the most 
straightforward of which is that the test pro¬ 
gram's “main” method must return one of 
a limited set of test-status indicators 
(PASSED, FAILED, NOT_RUN, and so on), 
On the face of it, this won’t work when 
the test program is large, preexisting, and 
not under the test creator’s control 

You can envision getting around this re¬ 
striction by arranging for the program Java- 
Test regards as the test to be a wrapper 
program that conforms to the JavaTest in¬ 
terface requirements and runs the appli¬ 
cation you actually want to test Howev¬ 
er, this approach does not solve the 
fundamental problem that only meager re¬ 
sults are passed back to the harness, with 
the result that, on the face of it, the har¬ 
ness will be able lu generate only a lim¬ 
ited report of test results. Clearly it is not 
enough simply to run tests automatically; 
reports that make it reasonably easy to 
pinpoint the causes of failures are also es¬ 
sential. When the test consists of just a 
few lines of code designed to exercise a 
single limited hit of functionality, a sim¬ 
ple PASS or FAIL report is fine. A GUI test 
that brings up a large, complex applica¬ 
tion and exercises it with a stream of in¬ 
puts to test a particular condition, on the 
other hand, has many potential points of 
failure. Consequently, the report of a fail¬ 
ing test needs to indicate where in the 
elaborate sequence of procedures the 
trouble occurred. 

A closely related issue is subtest¬ 
handling capability, The overhead of bring¬ 
ing up a large application such as java 
Workshop and manipulating it into a par¬ 
ticular slate for performing a set of tests 
makes it highly undesirable to restart that 
application for each individual test. The 
obvious solution is to bring it up once |x*r 
test, but to conduct several subtests with¬ 
in that test. In other words, as we exer¬ 
cise the application, we’ll check that var¬ 
ious conditions are satisfied along the 
way—tor instance, we may want to check 
that after a given button is pressed, a cer¬ 
tain dialog pops up, with a field filled in 
with a certain string. If the dialog does ap¬ 
pear properly, we may then want to ex¬ 
ercise it and check further results. If we 
conduct enough subtests as we exercise 
our application, we may not need much 
detail in reporting results for each subtest. 
The nature of die subtest and our knowl¬ 
edge of preceding subtest results should 
give us a pretty good idea what went 
wrong. Unfortunately, just as API-orient¬ 
ed harnesses such as JavaTesl fail to al¬ 
low for detailed reporting of results of each 
test, they also tend to tail to report the re¬ 
sults of subtests within an elaborate test. 


This Ls not to say that these harnesses are 
faulty, but that test developers need to rec¬ 
ognize dial harnesses designed for API 
testing (or for any testing based on run¬ 
ning small programs written solely to test 
a particular limited feature), cannot be ex¬ 
pected to have the special capabilities 
needed for large-scale GUI testing. 

Additional features we wanted, but that 
JavaTest lacked, included filtering capa¬ 
bility and reporting of golden-file differ¬ 
ences, We would like, for example, to cre¬ 
ate an interface with the Java Workshop 
GUI builder, generate source code for the 
interface, and then compare the generat¬ 
ed source with previously generated 
source tliat has l>een established to be cor¬ 
rect, or "golden*” We found iliac although 
JavaTest allowed for golden-file compar¬ 
isons, the resulting report merely indicat¬ 
ed whether the comparison succeeded or 
failed, not how the actual output differed 
from the golden version. 

Filtering is needed when a result (such 
as the content of a lext field) includes data 
that varies depending on the conditions 
under which the test Is run. The obvious 
example Ls the lull path of a file; for ex¬ 
ample, a file storing information aboui the 
project currently active in a development 
environment being tested. The first part 
of such a path will differ depending on 
where in the file system the test is being 
run. In comparing such a result with the 
expected value, we need to remove the 
variable part before doing the compari¬ 
son to avoid wasting time with false fail¬ 
ure reports. Again, Lhis sort of capability 
was not a priority for the API testing for 
which JavaTest was designed, so JavaTest 
did not provide it. 

JavaHamess 

Because JavaTest did not possess the 
needed GUI capabilities, I Ixgan work on 
an alternative harness designed with GUI 
testing in mind. This effort ultimately re¬ 
sulted in de velop mem of "JavaHamess,” 
a general-purpose harness for Java test¬ 
ing that SenTest makes available with 
JavaSTAR and favaScope (a Java coverage 
tool)* JavaHamess is, of course, written in 
java, so it will run wherever needed for 
Java testing. Because it was initially de¬ 
signed for GUI testing, JavaHamess natu¬ 
rally addresses some of die key require¬ 
ments neglected hv JavaTesl. JavaHamess 
reports subiest results, reports how golden- 
file comparisons failed, and provides fil¬ 
tering capabilities. 

For die Workshop Products group, an 
important attraction of JavaHamess is dial 
it enables us to use a single test harness 
to run all our test suites, including those 
already writLen for JavaTesl, JavaHamess 
can function as a meta-harness as well as 
a harness, allowing it to start up a Java¬ 


Test test suite instead of, or in addition to, 
one or more JavaSTAR test suites. The 
main JavaHamess configuration file, Java- 
Hamess5etup.ini, can include an essen¬ 
tially unlimited number of sections, each 
containing specifications for running a par¬ 
ticular test suite. For a JavaSTAR test suite, 
the specifications refer to a separate file 
containing a list of tests to be run. For a 
JavaTest test suite, the specifications point 
to die fjtp” file containing the informa¬ 
tion JavaTest needs to .set up and run a 
set of tests. 

The a 11-too-familiar pattern with test 
harnesses is that each is developed with 
a particular sort of testing need in mind, 
limiting its usefulness for other sorts of 
testing* JavaHamess attempts to be more 
flexible, providing interfaces that let users 
tailor its capabilities to a particular kind 
of testing. For instance, when API testers 
wanted to try using Java I larness to run 
their tests directly (rather than via Java¬ 
Test), it was easy to create a new Java¬ 
Hamess test type, CompikAndRun. The 
harness, when given a list of source files, 
then compiles and runs each in turn, re¬ 
porting how each test program’s output 
compares with the corresponding gold¬ 
en file. 

The chief drawback of JavaHamess, at 
this writing, is that it is still in an early 
stage of development. Though it provides 
the most essential harness capabilities 
needed to get a serious Java GUI testing 
program off the ground, we look forward 
to considerable refinement. 

Conclusion 

Though problematic, automated testing is 
essential to guarantee high quality in sub¬ 
stantial Java applications with complex 
GUIs. Though tods to help automate Java 
GUI testing are still immature and will 
doubtless become much more attractive 
with future refinement, they can already 
provide significant benefit 

In choosing tcx)|s for Java GUI testing, 
it is important to consider whether testing 
will be confined solely to Java GUIs or 
whether there will be a mix of Java and 
non-Java user interlaces* If the testing mu.st 
involve the use of non-Java interfaces, as 
in testing the running of applets under the 
control of a browser such as Netscape Nav¬ 
igator or Microsoft Explorer (which are not 
written in Java), have a look at Segue’s QA 
Partner. For testing purely Java applica¬ 
tions (or applets with Java-based browsers 
or players such as Hotjava or Applet- 
Viewer), tools written in Java are prefer¬ 
able due both to their direct awareness of 
AWT components and to the fact that their 
portability will automatically match that of 
the application being tested. 

DDJ 
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A Disassembler 
Written in Perl 


Using Peris built-in 

pattern-matching 

capabilities 

Tony Zhang 

R everse engineering has many ap¬ 
portions, including disassembly 
and microprocessor debugging. Dis¬ 
assembly can be helpful in under¬ 
standing code written by other pro¬ 
grammers. In this article. III present the 
core subroutines of a disassembler writ¬ 
ten in Perl This disassembler core is de¬ 
signed for the Intel x86 instruction set. 
You can modify or customize the disas¬ 
sembler for your own applications. To 
do so, simply design your application 
and write a low-level function to read as¬ 
sembled machine code (which may be 
from a static ,EXE file or a bus trace 
fetched at run time). You then call the 
core disassembler routines to translate 
the assembled machine code (that is, the 
EXE code) back into human-readable 
code, which should be close enough to 
the original source code for most pur¬ 
poses, For instance, I built a caller rou¬ 
tine based on bus trace data collected by 
a logic analyzer connected to a PC sys¬ 
tem. The caller extracts the executive 
code from the bus traces and disassem¬ 
bles it by calling the core disassembler 
routines presented here. 


Tony, a systems software developer at 
Texas Instruments, can be contacted at 
tt-zhang@ti.com. 


There are several reasons for writing 
Lite disassembler in Perl: 

* Perl has rich built-in features to easily 
manipulate text, files, and processes, 

• Perl is ideal for providing quick solu¬ 
tions to programming problems because 



it needs netdier a special compiler nor 
a linker to convert the source code to 
machine code. 

* Perl is rapidly becoming a popular 
scripting language across almost all plat¬ 
forms. 

Instruction Format 

Figure 1 shows the general format of the 
x86 instruction set. All instruction encod¬ 
ings are subsets of the general format. An 
instruction consists of four main parts. The 
first part is an optional prefix. The second 
pan — the opcode (operation code)—is 
the most important and is one or two 
bytes long. The third part is an address 
specifier consisting of the ModR/M and 
scale index base (SIB) bytes, also optional. 


The last is for displacement or immediate 
data, if required. 

Construct Instruction Look-Up Table 

Tlie file disasm.lut (available electronically; 
see “Availability," page 3) is an instruction 
look-up table based on die opcode map 
of the x86 instruction set given by Intel 
(see Pentium Processor Family Develop¬ 
er ’s Man ual Volt t me J. A rch itect u re a nd 
Programming Manual Intel 1995), The 
V is used to .separate the instructions and 
operand types. The number value of the 
first column indicates whether it is a 

1- byte opcode imp, a 2-byte opcode map, 
or another map determined by some 
attribute. 

Each operand follows a sign for 
parsing purposes. There are several win¬ 
dows in kbyte and 2-byte opcode maps, 
such as %g0 and %gfa-cfl that will link to 

2- byte or other code maps, 

A subroutine called “MakeLTIF is called 
to read the instruction look-up table into 
three arrays in memory when the disas¬ 
sembler is run for the first time. The three 
arrays are WOne_Byte_LUJ\ @Two_Byte 
_Lin\ and %Three_Bit_LUT. The last one, 
%Three_Bit_LUT, is an associative array, 
indexed by a string, $!sTemp_ l in the sul> 
routine MakeLUT. The associative array is 
one of the most important features in Perl 
because it can he used for efficient 
database manipulation. It’s often said that 
you are not thinking in Perl until you start 
thinking in terms of associative arrays. 

The second column in the instruction 
look-up table gives the start index to the 
arrays of @One_Byte_LUT and @Two_Byte_ 
LI T. For tlie associative array %7bree_Bit_ 
UT] the combination of the second and 
third columns is used as the index to It. 
For instance, when the string l:94:xchg 
%eax t %espxcbg %eax, %ebp.xchg %eax. 
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WE FINALLY MADE A WORKSTATION 


just like 


We finally made a workstation just 
as practical, reliable, and affordable 


eve r yo n e els e’s. 


as everyone else s. j Oi Desictop Workstation 

$ 7,495 

MIPS R5QD0 ISOMHi processor 
32-bit double-buffered graphics 
Hardware texture mapping 
Image processing engine 
Video compression engine 

Introducing The : Web-integrated user environment 

64MB ECC SDRAM 
2GB SCSI system disk 


With one minor 
exception: it’s better. 


only workstation that 
can combine industry- 
leading CPU and 


17" monitor, 1180x1040 
lOQBaseTXmJBaseT Ethernet 
CO-ROM 




SUiconGraphics 

Computer Systems 


graphics performance with 
breakthrough video and 
imaging capabilities. Why? 
Because 02 is the only work¬ 
station based on an innovative 
Unified Memory Architecture. 
Q2 comes standard with the MIPS® R50G0 ,M 
chip, and is also available with the much 
more powerful MIPS® R1G00G™ CPU, Best 
of all, 02 is designed to be an extrovert. 
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Every Q2 machine comes standard with 
a full set of web-authoring tools as well as 
a personal web server. So as soon as 
you plug it in, you can communicate 
your ideas to anyone, anywhere, on any 
computer. If you want the performance of 
a workstation combined with the power of 
the web, look for 02, It isn't hard to find. 
For more information, visit our Web site 
or call 800,636,8184 Dept. LSG055. 
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(continued from page 3& 

%esi:xchg %eax, %edi Is read in, MakeLLT 
first determines that the string should go to 
die array ®0ne_Byte_LUT } because the 
number in the first colutnnfjield) is 1. The 
number 94 will be used as the start index 
to the array. Therefore, it will look some¬ 
thing like Example 1(a) in the array 
®One_Byte_LUr after the reading. 

Similarly, after reading the string 
3;h:Q:add %Ev } %Iv:or %Ev i %lv:adc %Et\ 
%Iv.sbb %Ev, %Ib\ the associative array 
%Three_Bit_LUT will have four more 
items, as in Example 1(b). 

Parse Instruction 

The main routine of the disassembler core, 
X86_Disasm, accepts a string containing 
the name of a low-level function that will 
be passed to subroutine ImageByteRead 
to read in image data (that is, assembled 
machine code). Also, die start address (ei¬ 
ther a linear or physical address) and the 
operand size (16 or 32 bit) w ill be passed 
to X86_Disasm. An instruction that ac¬ 
cesses words (16 bit) or double words (32 
bit) lias an operand size attribute of either 
16 or 32 bits. 

When one byte of machine code is 
fetched by calling ImageByteRead, it is 
used as an index to find a string of sym¬ 
bolic instruction from array @One_Byte_ 
WT Then a while loop is applied in or¬ 
der to find prefixes in the symbolic string 
(see Figure 1). Fed provides two opera¬ 
tors to check pattern matching. In the 
while loop, you check whether the 
SlsOpcode contains %P or not by using 


Figure 1: Instruction format. 


one of the patterns matching operator 
SlsOpcode =-/\ %P */ 

The subroutine MethodP contains all 
four possible prefix groups: 

• Instruction Prefixes: rep, repe/repz, 
repne/repnz, and lock (where rep and 
repe/repz share the same cell in the 
opcode map). 

• Segment Override Prefixes: cs, ds , es, fs, 
g$, and ss. 

* Operand Size Override ( SDisasmnOS). 

* Address Size Override ( $DisasmnAS)< 

According to Intel, most instructions that 
can refer to an operand in memory have 
an addressing-form byte (the ModR/M 
byte) following the primary opcode 
byte(s). The ModR/M byte specifies what 
kind of address form is to be used. Also, 
in certain cases, the ModR/M byte is fol¬ 
lowed by a second addressing byte, called 
the SIB byte, that is required to fully spec¬ 
ify the addressing form. 

The disassembler I present here (avail¬ 
able electronically; see “Availability," page 
3) lias three subroutines— ModBits, Reg - 
Bits, and RMBits. These check the three 
fields of mod, reg, and r/m in the ModR/M 
byte. SIBField returns the displacement and 
the register number of the index register, 
or the base register, according to the for¬ 
mat of the SIB byte. Figure 2 illustrates the 
formats of the ModR/M and SIB bytes. 

After Lite prefix-adding while loop, the 
symbolic siring is parsed further to find if 
there are any links to arrays WTu’o_Byte_ 
HIT or %nree_Bit_WT> The pattern %g0 



Figure 2: (a) ModR/M byte format; (h) 
SIB byte format , 


implies that a new string of symbolic in¬ 
struction will be needed from @Two_ 
Byte_LUT y while %gla-ql leads to the as¬ 
sociative array %Three_BU_LUT, according 
to how you built your look-up table. 

Later, each character in the symbolic 
suing is extracted and checked in order 
to find the corresponding opcode, nec¬ 
essary information regarding the ModR/M 
byte, Lhe SIB byte, displacement, or im¬ 
mediate data. The Perl suhstr function is 
applied to extract those characters from 
the symbolic string. The tested characters 
will help to determine which subroutines 
should be called to interpret the opcode 
following the addressing methods. 

The subroutines in the sample disas¬ 
sembler complete the job of translating 
the symbolic siring into text-like assem¬ 
bly code for X86 instructions, 

* MethodA represents the direct address 
in which the instruction has no ModR/M 
byte except Lhe encoded address of the 
operand. Therefore, no base register, in¬ 
dex register, or scaling factor can be ap¬ 
plied in the addressing method. 

* While MethodC uses the reg field of the 
ModR/M byte to select a control regis¬ 
ter, Met hodD uses the reg field value to 
determine a debug register. 

* MethodE fetches the ModR/M byte that 
follows the opcode and specifies the 
operand, The operand can be either a 
general register or a memory address. If 
the operand is a memory address, it is 
calculated from a segment register and 
any of the following values: a base reg¬ 
ister, an index register, a scaling factor, 
or a displacement. Following the calcu¬ 
lated address, the subroutine can obtain 
all operand codes, convert them into 
proper formats, and save die results inLo 
a suing variable that contains die final 
disassembled code. 

* MethodM is basically the same as Meth¬ 
odE, except that MethodM is used only 
for a memory address. Similarly, Metho- 
dR is the same as MethodE, except that 
MethodR is used only for a general reg¬ 
ister. 


(a) $One_Byte_LUT [ 94 ] = "xchg 

/eax, /esp"; 

$On&_Byte^LUT[ 95 ] = "xchg 

/eax T /ebp" : 

$Gne_Byte_LUT [ 96 ] = "xchg 

/eax, /esi": 

$One_Byte_LUT[ 97 ] = "xchg 

/eax, /edi". 

<b) $Three^Bit J4rtC b:0 } = "add 

/Ev. /Iv"; 

$Three_Bit_LutC b:l } = "or 

/Ev, /Iv": 

$Three_Bit_Lut[ b:2 } = "adc 

/Ev* /Iv"; 

$Three_Bit_LutC b;3 3 = "sbb 

/Ev. /Iv". 

Example I: (a) Reading the array @One_Byte_LUT; f h) reading the array 

%Three_Bit_LUT. 





Prefixes Opcode ModR/M SIB 

Displacement/! immediate 

Prefixes: Instruction Prefix 

0 or 1 byte 

Address-size Prefix 

0 or 1 byte 

Operand-size Prefix 

0 or 1 byte 

Segment Override 

0 or 1 byte 

Opcode: 

1 or 2 byte(s) 

ModR/M: 

0 or 1 byte 

SIB: 

0 or 1 byte 

Displacement: 

0,1,2, or 4 byte(s) 

Immediate: 

0 r 1 t 2, or 4 byte(s) 
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(continued from page 38) 

• A general register on be selected by 
calling MetbodG, which checks the val¬ 
ue of the reg field in the ModR/M byte. 
For the immediate data encoded in sub¬ 
sequent bytes of the instruction, Metho- 
dl can be used. Method] computes the 
relative offset in an instruction and adds 
the offset to the instruction pointer. 

• For an instruction that has no ModR/M 
byte, the offset of the operand can be 
determined by calling MeihodO, In this 
case, the offseL is encoded as a word 
or double word in the instruction. The 
address-size attribute, $DisasmnAS, 
can tell whether it is a word or dou¬ 
ble word, 

• Finally, Methods selects a segment reg¬ 
ister by checking die value of the reg 
field in the ModR/M byte. 


There are three variable scopes in Peri— 
global (the default), local and my. The life 
span of the global is as long as that of the 
whole program module. A local variable in 
a calling routine can extend its life to a called 
subroutine. A my variable is limited to the 
scope of a routine itself, $ Disc tsmn Prefix, 
SDisasrnnOp, SDisasrmiModRM, SDdasmn- 
SIB ; SDisasmnDtspt, SDisasmnlmmed, and 
SDisasmnMapIndex are defined as local 
variables .so that they can be updated and 
passed easily among different subroutines. 

Currently, ImageByteRead returns only 
one byte at a time. The string $meni_read 
in ImageByteRead contains the name of 
a low-level function that reads an image 
file (assembled machine code) and returns 
data in bytes. The integer $hyte_imm de¬ 
termines how many bytes of data should 
be read and returned. 


Building a Sample Disassembler 

Disasm.pl (available electronically) is a 
sample disassembler that demonstrates 
how you call the disassembler core func¬ 
tion X86_Disasm when building disas¬ 
semblers, Essentially, the disassembler 
takes your input (in hex format, separat¬ 
ed by space), splits them into bytes, and 
save those bytes in memory. It then calls 
X86_Disasm to disassemble one byte at 
a lime, and prints the disassembled result 
on the screen. Remember the first item 
you feed into the disassembler should al¬ 
ways be the operand size (16 or 32), The 
disassembler keeps running until you type 
“q ,f to quit. You can run the program on 
under UNIX or Windows 95/NT. 

Branch-Trace Message Analysis 

One of the uses of the disassembler core 
in this project is to decode the branch- 
trace messages (BTM) collected from a 
logic analyzer. The disassembler is called 
by a program that can parse the bus cy¬ 
cles and extract BTM data by figuring out 
the target linear addresses and source lin¬ 
ear addresses. 

Once the code is retrieved, the disas¬ 
sembler can translate the code back into 
text-like assembly code by calling a low- 
level memory-read subroutine through 
ImageByteRead. I’ve tested the disassem¬ 
bler package on both UNIX and Windows 
platforms. The disassembled code matches 
the original source code (written in as¬ 
sembly) very well. 

Conclusion 

Clearly, there are many improvements you 
could make to this disassembler. You 
might want to rewrite Lhe code for Ex¬ 
ample 2(a) to Example 2(b) if you can 
make ImageByteRead return more than 
one byte at a time, so that you can re¬ 
duce the redundancy of the for loop. Also, 
you can add a subroutine to select a test 
register determined by the reg field of the 
ModR/M byte. Finally, you can add the 
part for the coprocessor (floating-point 
unit) instruction set, similar to the way 
the integer instructions were added in the 
article. 

Searching, extracting, and pattern 
matching are three things Perl does very 
well Perl lets you concentrate on logic 
Flow and algorithm design while it han¬ 
dles the implementation details—that’s 
the beauty of programming in Perl, 
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(a) 


<b) 


($i=$lnTenip ■ $i<$lnTemp + $DisaaninDispl; $i+*) C 
$IsResult = eprintf ("/02x M , 

&lFnageByte( $sKemRead, $i, 1 ) ) , SlsResulti 

] 


UsResult = sprintf (Vx". 

HIinageByte( SsMemRead, $lnTemp, $DisaanmDispl 


Example 2: The code in {h) is a rewrite of (a). 
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Examining the 
Windows NT 

Filesystem 


A layered organization 
with filesystem and 
hardware-device drivers 

Mark Russinovich 
and Bryce Cogswell 

T tie Windows NT filesystem is based 
on the same principles of layering as 
die Windows 95 filesystem (see our ar¬ 
ticle, IJ Examining the Windows 95 Lay¬ 
ered File System/' DDj, December 1995), 
but its device-driver model makes its im¬ 
plementation significantly different. In Win¬ 
dows 95 t for instance, die filesystem con¬ 
sists of 32 distinct layers, each responsible 
for specific tasks, such as resolving path 
names and converting horn logical to phys¬ 
ical offsets. Device drivers, upon loading, 
indicate to the I/O manager the devices for 
which they wish to lx? on die I/O request 
padi tor and which layers on die padis they 
will occupy. In Windows NT, on the odier 
hand, all I/O is device-object oriented and 

Mark is a consulting associate for Open 
Systems Resources and can be contact¬ 
ed at m a rbWm eat ball, osr com. Bry>ce is 
a researcher at the University of Oregon 
and can he contacted at cogswell@ 
cs.uoregon.edu. 


the layering protocol is built by the drivers 
themselves. Drivers create device objects 
and link them into chains associated with 
each physical or network drive. When a re¬ 
quest passes down a chain, drivers associ¬ 
ated with the device object receiving the 
request are notified via their associated han¬ 
dler procedures. 



In this article, we’ll open up die inner 
workings of the NT filesystem by de¬ 
scribing how a filesystem request origi¬ 
nates in a user's program and ends up as 
a disk access. In addition, well present 
an application called "Ftlemon" that mon¬ 
itors and displays all filesystem activity— 
paging, opening/ckxsing files, reads/writes, 
directory searches, and the like. (This mir¬ 
rors the filesystem API-monitoring capa¬ 
bility of the Windows 95 VxD-level call, 


IFSMgrJmtallFikSystemApiHook) filesys¬ 
tem API monitoring is useful for a variety 
of purposes, including profiling, virus de¬ 
tection, and security enhancement. 

The Windows NT Filesystem 

Any discussion of the NT filesystem re¬ 
quires an introduction to the NT device¬ 
driver model. The Windows NT I/O 
system is based on the concept of object- 
oriented, packet-driven I/O. This means 
that I/O requests CIRPs) are created as dis¬ 
crete packets of information and that their 
destinations are always some type of de¬ 
vice object. Device objects are created by 
device drivers to represent physical, log¬ 
ical, or virtual devices. A device objects 
driver Ls responsible for processing IRPs 
that are targeted at its device object. The 
I/O system serves as the glue that con¬ 
nects device objects and drivers. Besides 
providing infrastructure support routines, 
the I/O system works behind the scenes 
to route IRPs to target drivers and propa¬ 
gate return values back to the request- 
initiating driver. 

Because the NT I/O model does not 
make assumptions about how responsi¬ 
bilities will be divided among device 
drivers, it provides the drivers with die 
ability to locate objects by name. It also 
allows device objects to be attached to 
each odier. This enables one to act as a 
filter for another, prcxessing and taking 
decisions on IRPs before it sends them on 
to their destination. To make a device ob¬ 
ject visible to user-level applications, the 
driver exports a name to the \DosDevices 
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(continued from page 42) 
namespace inside the kernel (Objects in 
the kernel namespace can be examined 
using die WinObj utility provided with the 
NT 4,0 SDK.) Applications can reference 
names exported there and have their re¬ 
quests directed to the associated drivers. 
The layering supported by NT's driver 
model introduces three types of drivers, 
defined by how they interact with odier 
drivers: 

* Highest-level drivers create device ob¬ 
jects with exported user-space names 
and receive requests generated directly 
by user-level applications. 

* Lowest-level drivers receive requests 
only from other device drivers and act 


as the interface to the lowest level of 
abstraction a device supports-—usual¬ 
ly hardware such as a hard disk, 

• Intermediate-level drivers act as coor¬ 
dinators between a higher-level driver's 
requests and lower-level drivers: rout¬ 
ing requests, providing transparent error 
retry, or simply acting as filters. 

The generality of NT s approach to de¬ 
vice drivers means that a common infras¬ 
tructure is used to support all types of de¬ 
vices— physical (keyboards, sound cards) 
and logical (disk partitions). It also means 
that the I/O system know s little about the 
filesystem, since this abstraction is pro¬ 
vided by the drivers themselves. Conse¬ 
quently, it is difficult to describe the NT 


filesystem as having an absolute organi¬ 
zation; its architecture is not defined by 
the NT I/O system. However, there is a 
de facto standard for the general struc¬ 
ture. The support provided by the I/O sys¬ 
tem, as well as the existing base of Micro¬ 
soft filesystem and hardware drivers, make 
it much easier to follow design guidelines 
that are in use than to implement a new' 
architecture. 

As Figure 1 illustrates, filesystems cur¬ 
rently found on NT generally have only 
two layers. The first layer consists of 
filesystem drivers, which define the lay¬ 
out of data in the filesystem; these com¬ 
municate with the second layer, which 
consists of the lowest-level hardware 
drivers— those that read and write infor¬ 
mation directly on tire underlying storage 
medium. Additional layers can be present, 
though: Some hardware devices have 
drivers divided into sublayers where high¬ 
er levels deal with classes of devices and 
lower levels address specific types. Fur¬ 
thermore, intermediate-level drivers are 
often inserted betw een a filesystem and 
the tower-level drivers to provide addi¬ 
tional functionality such as disk mirroring. 

Figure 1 doesn’t show' how the I/O su¬ 
pervisor's glue connects the drivers, via 
device objects, nor does it show the kinds 
of information sent in a request and how 
that information is packaged. These de¬ 
tails are shown in Figure 2, which fol¬ 
lows a request through several layers 
from a Win32 program down to a hard 
disk and back. 

File and Device Objects 

File objects represent files in the same way 
device objects represent devices. All NT 
filesystem requests must have a file ob¬ 
ject as their reference; see Listing One (list¬ 
ings begin on page 85). The first task of 
the I/O supervisor is to lake the user s re¬ 
quest; if the request does not reference a 
previously opened handle, the supervisor 
creates a file object. A handle to the ob¬ 
ject is returned to the application, and fur¬ 
ther operations on the same file can be ini¬ 
tialed by referencing die handle. Calls tliat 
Create a file object, such as the CreateFile 
call, must supply enough information so 
that the filesystem know s precisely which 
file is being opened. This information is ei¬ 
ther a full path name (C:\foo\bar.txt), or 
an implied current directory (C:\foo) and a 
relative path name (bar,txt). 

The I/O supervisor determines the re¬ 
quest's target logical drive (in tills case, CA) 
by extracting it from the full path name. It 
then determines the physical partition on 
which the drive resides. This is done by 
looking up the drive letter in \DosDevices, 
the kernel’s internal exported-name direc¬ 
tory. Logical drives are normally repre¬ 
sented in this internal table with symbolic 
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links to another name that identifies the 
device object representing die drive. A ref¬ 
erence to this device object is stored in 
the file object so that future requests can 
skip this look-up step. 

For example, a system where C:\ is die 
first partition on die first hard disk might 
have an entry N \DosDevices\GV' dial is 
pointing to a symbolic link with the val¬ 
ue w \device\ harddisk0\ partition 1.” Once 
it has found the device object for the drive, 
it determines which filesystem device ob¬ 
ject is associated with it by looking at die 
partition’s volume parameter block— a 
data structure in the device object that 
links a partition to a filesystem. 

With the filesystem device object in 
hand, die I/O supervisor creates an IRP 
for the request An IRP is simply a data 
structure (see Listing Two) that carries 
information about a specific filesystem 
request, This includes the request type 
(open, read, write, query, and so on) and 
associated file object (the handle of Lite 
file to be operated upon), as well as stor¬ 
age for intermediate driver-specific in¬ 
formation, buffer pointers, and status 
flags. The I/O supervisor is responsible 
for sending the newly created IRP to the 
top-level device driver on the chain as¬ 
sociated with the target drive, typically 
the filesystem driver. 

Drivers 

Each driver in the chain has multiple dis¬ 
patch entry points, dedicated to process¬ 
ing specific types of filesystem requests. 
The set of entry points is defined by the 
MajorFunction table in the driver object. 
Tlie I/O supervisor invokes the driver via 
the loCaUDriver call, passing die target 
device and IRP as arguments, and in¬ 
dexing into the driver’s table of registered 
request-type handlers. There it finds the 
procedure in the device driver that pro 
cesses the particular request type. 

At this point the filesystem driver takes 
over. Its actions depend largely on die 
type of filesystem it serves and the type 
of request it has been sent. For accesses 
to Files on a local FAT, HPFS, or NTFS 
drive, the filesystem driver is FASTFAT, 
HPFS, or NTFS, respectively, For access¬ 
es to a CD-ROM, the driver is usually 
CDFS, while for network drives, die driv¬ 
er is usually NWRDR, the network redi¬ 
rector filesystem. Looking again at Fig¬ 
ure 2 (where the access is to a FAT 
partition), we can see that FASTFAT de¬ 
termines w hich logical sectors on the 
drive must be accessed to complete the 
request. It then creates one or more new 
IRPs that it sends to the device object 
representing the partition, in this case the 
one named w \ device \harddiskO\ parti¬ 
tion!.'” The I/O supervisor routes the IRPs 
to die correct handler procedure in the 


device driver tfiat owns the partition’s de¬ 
vice object. The example path ends up 
in the ATDISK device driver, which is the 
standard IDE-type hard-disk driver. AT¬ 
DISK interacts with the hard disk, and 
upon completion of the disk action, sends 
a message back to FASTFAT, indicating 
that it has finished servicing the request, 
passing a status value back in the IRP. 
The return route continues back up the 
driver chain, and, as indicated by the red 
lines in Figure 2, does not go through 
the device-object path. 

The path and procedure followed by a 
CD-ROM, floppy, or other local request is 
similar to Figure 2. If the target drive is a 
network drive, however, the filesystem 
driver does not perform die task of trans¬ 


lating the request to logical sector ac¬ 
cesses, Instead it serves merely as a 
proxy for a filesystem driver, such as 
FASTFAT or NTFS, residing on the re¬ 
mote node. It forwards the request to 
the remote node using a device driver 
for the network card on the local ma¬ 
chine and then presents the results to 
the user application when they are re¬ 
ceived from the network. 

Variations 

The process whereby the I/O supervisor 
creates an IRP to send to filesystem 
drivers allows for great flexibility in the 
way a driver can respond to a request. 
It can reply immediately with a negative 
result (for example, if it determines the 
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file or file handle does not exist); it can 
take the 1RP and pass it to low-level 
drivers; or it can create several new IRPs 
to send to lower drivers. 

The NT I/O model makes special al¬ 
lowance for the performance demands 
of filesystem drivers in an optimization 


that can sometimes be used to avoid the 
creation of an IRP, This backdoor to die 
filesystem is known as the “fast I/O 
path." A filesystem device driver can 
specify in its driver- object data structure 
a table of routines that can be called di¬ 
rectly to handle simple requests* The 
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User Space 
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CD-ROM File¬ 
system Driver 


Network Redireeter 
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AT Disk 
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Driver 
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Figure 1: Typical Windows NTfllesystem organization. 
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I/O supervisor uses one of these short¬ 
cuts when it is likely that a filesystem 
access will be served from the disk 
cache. If the filesystem driver cannot sat¬ 
isfy the request without calling lower-lev¬ 
el drivers, ii fails the Fast I/O call and 
the I/O supervisor proceeds with nor¬ 
mal IRP creation. This fast path saves 
the memory allocation and setup re¬ 
quired to perform an IRP-based request. 

The Filemon Application 

To demonstrate this device-driver and 
device-object model, we have imple¬ 
mented an application called “Pilemon" 
that layers above filesystem drivers by 
creating hook-device objects and at¬ 
taching them to logical-drive device ob¬ 
jects. Filemon's device driver sees every 
request directed to any of the system's 
logical drives. 

The Fi lemon application, which runs 
under NT 3-51 and 4.0, consists of two 
separate components — a Win32 GUI 
called Tilemon.exe 11 (see Figure 3), and 
an NT device driver called Tilemon.sys.* 
Filemon.sys is a dynamically loaded de¬ 
vice driver; no installation procedure is 
necessary since fjlemon,exe loads it. 
During initialization, Fi lemon determines 
the types of logical drives present and 
lets users select the set of drives to be 
monitored t including hard disks, CD- 
ROMs, floppies, network drives, and RAM 
drives* 

During execution, Fi lemon dumps in¬ 
formation about all requests directed at 
the set of monitored drives. This infor¬ 
mation includes number of requests, re¬ 
quest iypc t path name of the associated 
file, result status, and any request-specific 
information such as file offsets and 
lengths* 

Information-Handling Issues 

A frequently seen request type is IRP_ 
MJ_CLFANUP, and its purpose is a little 
less obvious than most of the requests* 
Each Die object has both an open count 
and a reference count associated with it. 
The open count is the number of open 
user-level handles ihal currently refer to 
the object. The reference count indicates 
the number of references, made by open 
handles as well as by other objects in 
the kernel, to a file object. The open 
count is always less than or equal to the 
reference count. When the open count 
drops to zero, die I/O supervisor sends 
the filesystem a cleanup request telling 
it that any outstanding IRPs it may have 
for the f ile object need not be complet¬ 
ed since no user is waiting for a result. 
When the reference count drops to zero, 
the file object can be closed, and the 
filesystem will receive an IRP_M]_CLOSE 
request. 
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A. Software configuration management (SCM) is 
the process of tracking and managing software 
development projects of any kind. A quality SCM 
solution should provide such functionality as version 
control, workflow features, and advanced security 
It enables development teams to deliver mission 
critical software or even create new intranet-based 
applications in a controlled, project oriented manner. 


you to see differences in code—additions, 
deletions, changes—by color coding, but the 
ability to merge these changes as you see the 
differences will really hump up your productivity. 

Q. HOW EASY IS IT TO GET MY TEAM 
STARTED? 

A, Choosing the right SCM tool is a decision 
you shouldn’t take lightly Consider things like 
the number of platforms you'll be running on, 
which policies your company wants to 
implement, the importance of security, and the 
location of your existing files. Installation of the 


software should be simple (depending on what tool 
you select). Adding existing files to the new system 
should be as easy as a few clicks of a mouse. 

Q. IS SCM EXPENSIVE? 

A. When you select an SCM system, cost is always 
a factor. Look for a comprehensive solution that 
meets all your criteria, right out of the box. You 
don’t want to drain your budget to keep it running 
after insinuation, or continually add costly pieces 
of functionality that weren't included in the 
original price. 

Until next time, this has been Dr. Morty on how to 
choose a software configuration management system. 

And remember, change Is good 

You can write to Dr. Morty at: 
morty@mks.com for your 
specialized SCM requirements. 


Q. HOW WILL SCM BENEFIT MY 
R&D TEAM? 

A. Your entire team—from project leaders to 
developers and testers—will henefu from a 
controlled development process. Properly managed 
source code prevents bottle-necks in development, 
testing and QA, eliminates code collision and 
increases productivity. It enables you to easily 
retrieve earlier versions of code so your team can 
respond quickly to market demands. The bottom line 
is that properly managed code becomes shipping 
cod e faster. 

Q. WHAT SHOULD I LOOK FOR IN AN 
SCM TOOL? 

A, Control and productivity is the key. Consider 
basic functionality' such as easy check-in and check¬ 
out; project check pointing to quickly re-create past 
releases, and re-use of code across projects— 
a real time saver! Keep in niind the benefits provided 
by individual work environments that allow team 
members to work independently of other changes. 

A strong security' feature is a must to ensure 
protection for your valuable source code, 

Q. HOW IMPORTANT IS INTEGRATION INTO 
VARIOUS DEVELOPMENT ENVIRONMENTS? 

A. Very important, but don’t be fooled. All hooks 
are not created equal. Look for a tool that will let 
your team work in their preferred development 
environment with seamless integration back into 
die SCM system. 

Q. I WASTE A LOT OF TIME FIGURING OUT 
CHANGES BETWEEN FILES—IS THERE AN 
EASY WAY TO MERGE CODE? 

A. Good question. Merging code is easy, especially if 
your SCM solution provides a “Visual Differencing" 
and a "Visual Merge' f function. Most products allow 
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die data as a direct I/O file object. Later, 
when the cache wants to flush out to disk, 
FASTFAT will receive a request with byte 
offsets relative to the start of a logical drive 
as a reference, rather than relative to the 
start of a file. 

Direct I/O is also used by administrative 
software such as FORMAT or CFIKDSK, 
These utilities write directly to disk sec¬ 
tors, bypassing the structure imposed by 
filesystem drivers. If you format a floppy 
disk while running Filemon, for instance, 
you will see FORMAT accessing the flop¬ 
py disk via direct I/O. 

An interesting result of the asyn¬ 
chronous behavior of many filesystem re¬ 
quests is the possibility of outstanding IRPs 
at GUI shutdown. When this is the case, 
Fdemons device driver cannot unload, be¬ 
cause when an outstanding [RP completes, 
the 1/0 supervisor will attempt to call tile 
I/O completion routine that Filemon has 
registered, regardless of whether it is in 
memory, (You can imagine the outcome 
if the device driver has been unloaded ) 
Under these circumstances, the GUI ex¬ 
its, but the driver remains memory resi¬ 
dent to handle these last 1RP completions. 
If another instance of she GUI is started, 
it connects with the already loaded driv¬ 
er image; at exits of these subsequent GUI 
instances, a check is made again to see if 
the driver can unload cleanly. 

How Filemon Works 

When the GUI starts, it initiates a load of 
the Filemon device driver (see the INST- 
DRV example in the NT DDK under 
SRC\ GENERAL \ IN5TDKV for an example 
of dynamically loading a device driver). 
During initialization, the device driver cre¬ 
ates a device object with the kernel ob¬ 
ject name “\ Dos Devices \ FILEMON,” so 
that the GUI can communicate with it via 
Create! Ue and DeviceloControl calls. The 
GUI then requests the driver to hook the 
set of drives desired by the user. 
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Figure 3: The Filemon GUI\ 


(continued from page 46) 

On an unrelated note, File men's de¬ 
vice driver dynamically allocates storage 
in which to save filesystem request 
records. Although rare, it is possible for 
a system to generate requests fast 
enough that buffering all requests for 
the GUI would require too much mem¬ 
ory If tliat happens, some records may 
be dropped intentionally, reflected as a 
gap in the sequence of records displayed 
by the GUI. 

There are two situations where the path¬ 
name displayed Is a drive letter Mewed by 
the text “DIRECT I/O." One is when the 
disk cache is flushing data that lias no as¬ 
sociated name. For example, in the FAT 
filesystem, the file-allocation table itself has 
no name. However, it is still desirable to 
cache file-allocation tables for quick access. 
The FASTFAT driver therefore has to cache 
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Key 

I/O Supervisor 
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->. Driver Request 
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Figure 2; Example filesystem 
control flow. 
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To hook a drive, the device driver must 
first determine the device object that rep¬ 
resents it. It uses the same technique that 
die kernel uses to determine the logical - 
drive device object referenced by an access 
to a previously opened file object (see List¬ 
ing Three). The device driver calls the ker¬ 
nel’s internal open-file call, ZwCreateFile, 
on the root directory of the target drive 
(C:\, for example), This returns the nec¬ 
essary file-object handle. Next, it maps the 
handle to an actual file-object pointer, us¬ 
ing OhRitferenceQbjectByHandle, Finally, 
the device object associated with the hie 
object is retrieved with loGetRetated- 
DeviceOhject. 

Once a logical drive’s device object has 
been located, the driver creates a hook- 
device object and attaches it to the drive’s 
object via loAttachDeticeByPointer. There¬ 
after, the hook object receives all requests 
directed to the logical drive’s top-level 
driver. Except for dealing with the fast I/O 
path, the rest of the device driver’s chores 
are straightforward. It simply roisters han¬ 
dler routines for requests directed to 
filesystem drivers and pulls information 
abouL requests out of the LRPs it sees on 
their way to the filesystem. An I/O com¬ 
pletion routine is registered for each re¬ 
quest so that the driver can see the asso¬ 
ciated return status. 

Handling the fast I/O path is tricky 
because it is not documented in the NT 
DDK, A Biter driver such as Filemon can¬ 
not ignore this control path because the 
I/O supervisor assumes that filesystem 
drivers have at least some fast I/O calls 
implemented; ignoring them leads to a 
quick system crash. Fortunately, the fast 
I/O call prototypes and table definition 
are included in the DDK’s main include 
file, NTDDK.H, so adding fast I/O rou¬ 
tines to a filter driver is straightfor¬ 
ward— once the problem is understood. 

Filemon copies ASCII text describing 
each request to a buffer that it transfers 
to Lhe GUI periodically. Although only 
the most significant aspects of each trans¬ 
action are recorded, the application is 
easily extended to display any data con¬ 
tained in the IRP, Unfortunately, much of 
the information packaged with requests 
is not documented. For many purposes, 
including enhanced security, profiling, 
and virus detection, the data collected by 
Filemon is sufficient. However, until 
Microsoft produces its much-awaited 
filesystem documentation, you must be 
prepared to put on your spelunking gear 
and gcL dirty with a kernel-mode de¬ 
bugger if you want a more detailed un¬ 
derstanding. 
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EMBEDDED SYSTEMS 


Robots and 
Finite-State Machines 


Walking the walk 
with mobile robots 

Everett F. Carter, Jr. 

D esigning and building autonomous 
robots presents a host of technical 
challenges* On [he hardware side, 
for instance, you have to contend 
with computational and interface elec¬ 
tronics, torques, pulleys, gears, and levers. 
On the 1 software side, die challenges in¬ 
volve real-time data acquisition, real-time 
process control, artificial intelligence, and 
other issues familiar to embedded-systems 
designers, In this article, 111 describe the 
high-level processing I implemented in a 
robot designed for researching robot-control 
systems. (The source code implementing 
tills processing is available electronically; 
see “Availability,” page 3J 
Since the purpose of this robot was to 
examine the control problems at a rela¬ 
tively high level, you may wonder why ! 
went to the trouble of building a physical 
robot instead of just developing the nec¬ 
essary control techniques through simu¬ 
lation, The main reason for building the 
device is that it is extremely difficult to 
honestly simulate the effects that occur in 
a real, uncontrolled environment: Infrared 
sensors can give false positives or nega¬ 
tives, the sonar system can see false 
echoes (or the sound gels absorbed in¬ 
stead of reflected by an object), motors 
can stall, power supplies sag, and walk¬ 
ing robots can tumble when the center of 
gravity shifts. All these effects can be a 


Everett is president and senior software 
develops for Taygeta Scientific and pres¬ 
cient of the Forth Interest Group. He can 
he contacted at skip@ taygeta.com or 
httpffwwuK taygeta . com/, 


challenge to realistically simulate. Cunse- 
quendy, simulations arc necessarily ideal¬ 
istic, and so, to quote R.A. Brooks and 
M.J. Mataric, “Simulations are doomed to 
succeed* (Real Rolxjts. Real Learning Prob¬ 
lems," Robot Learning, edited by J.H, Con¬ 
nell and S. Mahadevan, KJuwer Academ¬ 
ic Publishing, 1993)- Of course there is an 
even more important reason to actually 
build a robot—it’s fun. 

Anatomy of a Robot 

The robot I built is a six-legged walking 
robot approximately 22 inches long and 
10 inches wide, with 7-inch long legs. Its 



sensors consist of a pair each of ranging 
ultrasonic sonars, active infrared HR) light 
detectors for proximity detection, and 
contact sensor whiskers about 8 inches 
long. The sonar works in the range of 
alxiut 9 inches to 30 feet, and is used for 
long-distance object detection and map¬ 
ping. The IR system is tuned to detect ob¬ 
jects from about 14 inches away. The 
whiskers detect actual contact of the robot 
with an object. 

All sensors are mounted on a sensor 
head that can move +/- 45 degrees to 
either side, as well as up and down. Putting 
the sensors on the head eliminates the 


need for expensive rings of sensors that 
are common on autonomous robots, but 
adds the complication of having to know 
where the head is pointing in order to pro¬ 
vide a proper context for the sensor data. 

In theory, the sonar system can pick 
out an obstacle before the IR notices it 
and both of these should report it before 
the contact sensor detects it* Tills redun¬ 
dancy improves the reliability of the robot 
since each of these object-detection mech¬ 
anisms uses a different physical principle, 
making it less likely that they would all 
fail to see something. 

Building a walking robot is consider¬ 
ably more challenging than I originally 
anticipated. After several frustrating weeks, 
I learned the techniques required to get 
a statically stable robot (as opposed to a 
dynamically stable robot which needs to 
actively balance itself) to successfully 
walk, S.M. Song and KJ, Waldrons Ma¬ 
chines that Walk. The Adaptive Suspen¬ 
sion Vehicle (MIT Press, 1989) is an ex¬ 
cellent source of information on motion 
control for this kind of robot. After ex¬ 
pert men tali on, 1 developed a library of 
possible gaits for the robot. Each gait con¬ 
sists of a sequence of (what l call) cycles 
for each of the six legs in a particular or¬ 
der* A cycle consists of: 

* Raising the leg, 

* Swinging it forward or backward a cer¬ 
tain amount. 

* Lowering the leg back to the ground. 

* Pushing or pulling the leg back to the 

centered position again* 

By combining variations in forward and 
backward cycles, and in the order of the 
sequence of legs being moved, the robot 
can be made to walk forward, backward, 
turn in either direction, and handle vari¬ 
ations in die slope or roughness of the 
terrain* Song and Waldron describe some 
very elaborate gaits for doing things such 
as negotiating steps, crossing trenches, and 
moving over fences. 


50 


Dr. Dobbs Journal, February 1997 













Do more with less. 


Most operating systems leave little room for important 
things. Like your application. 

With the QNX realtime OS you'll pack more functionality 
into less memory. Achieve more performance with 
less-expensive CPUs, And deliver better solutions at 
a lower price. 

Better yet, QNX supports more PC hardware than any 
other realtime OS. Whether it's PC/104 or PCMCIA, 
embedded X86 or the Pentium® Pro, QNX lets you use 
it right out of the box. Get to run time in less time! 


More scalable than ever! From low-end to 
high-end, QNX offers you the ultimate in scalability. 

Even your deeply embedded systems can boast a 
scalable POSIX RTOS, thanks to our new, exceptionally 
small Neutrino" microkernel. 

And if you need to add the capabilities of a high-end 
GUI to your low-end system, you can. Our award-winning 
Photon microGUP gives you a phenomenal front end, 
with enough memory left over for important things . . . 
like your application! 


www.qnx.com 


Call 1 800 676-0566 (ext. 1328) 
or email info@qnx.COtn 



The Leading Realtime OS for PCs 


QNX Software Systems Ltd., 175 Terence Matthews Crescent. Kanata, Ontario, Canada K2M I WE Voice: 613 591-0931 Fa*: 613 591-3579 
Europe: 49 Dove Park. Ch or ley wood. Hertfordshire. Voice. (44) [0)1923 2S48QQ Fan: (44)tO)1923 285568 Email: QNXeurnpEeqrix-corti 

QNX Software Syrtim* Ltd I 9-96 QNX It » Tegnlafid tree]D-merlr end Neutrino end Photon inltroGifl in It. demerit nf QNX Software Sjaterm Ltd. All* oilier trldimspfcs (relong id 1h«>r mftairt OWriari 


CIRCLE NO. 134 ON READER SERVICE CARD 









(continued from page 50) 

There are two major categories For 
walking- machine gaits: periodic and non¬ 
periodic, Nonperiodic gaits are useful in 
complicated terrain and require foot con¬ 
tact and pressure Feedback to be useful 
Periodic gates always repeal the sequence 
of cycles and are easier to implement. 

Tlie gaits I generally use with the robot 
are backward-wave gaits and equal-phase 
gaits. Wave gaits have the best stability mar¬ 
gin and are commonly used by animals. In 
backward-wave gaits, the phase of the leg 
placement sequence on each sick runs From 
the front leg to the rear (there is also a 
forward-wave gait that runs die other way). 
Equal-phase gaits are not common in na¬ 
ture, but For robots they can be very use- 
llil These gaits distribute the placing and 
Sifting of the legs evenly over the complete 
motion cycle, which means that the pow¬ 
er demand to drive the legs is relatively 
even. As a result, equal-phase gaits are veiy 
popular in walking robots that are hy¬ 
draulically or pneumatically driven. 

Two of the gaits in the library that J use 
for walking forward are the backward- 
wave gait sequence (1, 2 T 3, 4, 5, 6) and 
the equal-phase gait sequence (I, 4 , 5, 2, 
3, 6). By convention, walking-machine 
legs are numbered From front to back, 
with odd numbered legs on the left and 


even numbered legs on the right. These 
particular sequences do a complete cycle 
of one leg before starting the cycle For the 
next leg. Some gaits have overlapping tim¬ 
ing of the cycles. In these, die robot can 
move more quickly, but is less stable. 

The robot has a hierarchical design. At 
the very low levels, [ used dedicated 
microcontrollers to control functions like 
generating the real-time PCM signal to 
control the leg servo motors (this is done 
with an MC146805KI processor for each 
leg) and mod u la Ling the IR and de¬ 
bouncing die contact switches (this is done 
with a Basic Stamp PIC controller). 

High-level decisions and evaluations of 
die robot's environment required a micro¬ 
processor. The high-level system I used 
is a single-board MC68332-based system 
from New r Micros Inc. In this article, 111 
primarily focus on the software dial re¬ 
sides on tliis system. 

Since the robot is designed to lie auto¬ 
nomous, diere is no special user interface. 
You communicate with die master CPU via 
its built- in RS-232 interface anil interact 
with its on-board Forth interpreter/com- 
pller. The Forth system acts as both an op¬ 
erating system and programming language 
for the robot. Forth is nice for developing 
robot-control software because it can be 
incrementally compiled and tested in small 


parts. For example, to detennine how high 
to step while walking* I mounted the robot 
on its test stand (a camera tripod) and 
typed in the command to select one leg, 
tlien typed tfie command to raise it until 
it looked right, Having a 32-bit processor 
like the 68332 as die master CPU was a 
joy. Not only is the 68332 a useful pro¬ 
cessor For controlling devices (because of 
the large number and flexibility of its I/O 
lines), but it has the computational pow f - 
er to do sophisticated processing and still 
satisfy the real-time needs of controlling 
a robot. 

The Motorola 68332 

The short description of the Motorola 
32-bit 68332 microcontroller is that it Ls an 
updated 68000 processor with .several inte¬ 
grated coprocessors for memory manage¬ 
ment and I/O support. The two most im¬ 
portant coprocessors are the Queued Serial 
Module (the QSJV1) and the Time Processor 
Unit (the TPU). 

The QSM provides a pair of asyn¬ 
chronous serial I/O lines and several SPI 
synchronous I/O lines. Using the asyn¬ 
chronous I/O is much like having a UART 
on chip: You set a few configuration reg¬ 
isters, which control such things as the 
baud rate, parity * and so on, and then se¬ 
rial I/O can lie am in the background with 
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no need for direct management from die 
CPU, The SPI section of the QSM imple¬ 
ments Motorola's bit-synchronous I/O sys¬ 
tem. This is a three-wire (Master-In, 
Master-Out, and Clock) system that is sup¬ 
ported by many devices such as A/D 
chips. There are significantly more regis¬ 
ters to set in order to use SPI, because of 
the large variety of possible configura¬ 
tions. The data-transfer protocol is differ¬ 
ent, but conceptually, the configuration 
mechanism is same as the asynchronous 
I/O; You configure the subsystem by set¬ 
ting the registers and then die I/O occurs 
in the background. Without adding ex¬ 
ternal circuitry, up to four SPI devices 
can be used; a little bit of select dectxl- 
ing logic allows 16 devices to be used. 
For more details on the QSM, see “Time 
for the 68332/’ by Eric McRae (DDJ r Jan¬ 
uary 1995), 

'Hie TPU is an extremely powerful I/O 
subsystem. It provides up to 16 I/O lines 
running up to 10 different I/O functions. 
Many of these functions involve timing in 
one form or another. The TPU is a bit in¬ 
timidating to learn to use. It takes writing 
half-a-dozen bytes just to set up to do a 
simple toggle of an I/O bit. But you can 
also wriLe half-a-dozen bytes to set up pe¬ 
riod measurement with additional transi¬ 
tion detection, or a stepper-motor con¬ 


troller with programmable acceleration 
and deceleration. Using die interpreter and 
incremental compilation features of Forth 
on the New Micros single-board 68332 
system makes learning to use the TPU 
much easier. The TPU is described in more 
detail in “Inside Motorola's TPU,” by 
Richard Soja (DDJ, December 1996), 

Finite-State Machines 

Since the control software for a robot op¬ 
erates on many different levels, it needs 
to he well factored, or it quickly becomes 
unmanageable. For small systems, a finite- 
state machine is a natural way to partition 
die problem. This is a conceptualization 
of the system as always being in one of 
several states. The system makes well- 
defined moves from one state to another 
in response to inputs or events. For ex¬ 
ample, consider die state machine in Fig¬ 
ure 1 that describes how die robot will re¬ 
spond to bumping into something. In this 
mactiine the states are; 

* BUMP_SCAN when there is no contact. 

* LEFT_BUMP when the left whisker 
makes contact (by design, the robot 
treats die situation where both wliiskers 
make contact as a left contact). 

* RIGHT_BUMP when the right whisker 
makes contact 


There is an additional state, END_BUMP, 
which the robot enters when a left or right 
contact ends. The END_BUMP state exits 
back to BUMP_SCAN after a timeout 
period has expired. This gives the robot 
the time to turn away from the obstruc¬ 
tion. In the strictest computer-science 



Figure 1: An augmentedfinite-state 
machine to manage collisions bettveen 
the mhot and an object. The action that 
the robot takes upon exiting a given 
state (in the circles) is in the parentheses 
for each of the transition paths . 
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definition of a finite-state machine, timer 
events (like timeouts) are not allowed; 
augmented finite-state machines that do 
recognize timer events, however, are com- 
mon in process-control systems. 

The IsoMax system 

The New Micros IsoMax system is a fi¬ 
nite-state-machine engine that sits on 
top of a Forth compiler. Typically you 
write the low-level control code in ei¬ 
ther assembler or Forth, and the high- 
level system as a set of interacting state 
machines. IsoMax internally provides the 
glue to drive the system through the 
states and to run all the state machines. 
You can then concentrate on describing 
the application specifics and not worry 
about building the state-machine engine 
itself. 

Using isoMax is straightforward. You 
basically write a specification of all the 
state machines, lliere are four fundamental 
sections of an IsoMax state-machine 
specification: 

* The list of states that apply to a given 
state machine. Example 1(a) defines the 
machine PROXIMITY to consist of five 
different states, 

■ For each state, give the conditions that 
cause a transition to another stale. Ex¬ 


ample 1(b) sets up die response of the 
PROXIMITY machine when it is in the 
state IR_SCAN, If the word BOTH_IR? 
returns a True condition, then the se¬ 
quence of Forth words between CAUSES 
and THEN-STATE run (which causes the 
robot to back up). After tills, the state 
switches to BOTH JR. The machine can 
have as many of these clauses as nec¬ 
essary. Only the conditions that must 
be acted upon need to be listed in the 
IN-STATE.,,TO-HAPPEN clauses; all 
other conditions leave the machine in 
the current state. 

* Next, all die defined state machines are 
linked into a single list of machines, 
which make up a composite-state ma¬ 
chine that is to tx* am (Example 1(c)). 
In IsoMax, no priority is implied by die 
order of the machines in Lhis list. Prior¬ 
ities or subsumption overrides must be 
built into the supporting words. In my 
robot, the stale transitions cause a word 
that 1 wrote, ARBITRATE, to tie called 
either directly or indirectly This simple 
word chooses one of several possible 
actions (set by each state machine) on 
a priority basis. 

• Finally, before actually running the ma¬ 
chine chain, the initial state of each of 
the state machines must be defined; see 
Example 1(d). 


(a) STATE-MACHINE PROXIMITY 

APPEND-STATE IR_SCAN 
APPEND-STATE LEFT.IR 
APPEND-STATE RIGHT.IR 
APPEND-STATE BOTH.JR 
APPEND-STATE END.IR 

(b) IN-STATE IR^SCAN 

CONDITION ROTH.IR? 
CAUSES PROXIMITY.VEC 
SET.REVERSE ARBITRATE 
THEN-STATE BOTH,IR 
TO-HAPPEN 

(c) MACHINE-CHAIN ROBOT 

SENSORS 

WALKER 

CONTACT 

PROXIMITY 

EXPLORE 

END-MACHINE-CHAIN 

(d) WALK.FORWARD SET-STATE 

XR_SCAN SET-STATE 

BUMP.SCAN SET-STATE 

IDLE SET-STATE 

IDLE.MOTION SET-STATE 


Example 1: (a) Ihe PROXIMITY 
machine; (h) setting up the response of 
the PROXIMITY machine; (c) linking 
state machines into a single list of 
machines, which makes up a composite - 
state machine: (d) defining the initial 
state of each state machine. 
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(continued from page 54) 

Subsumption 

Implementing a complete robot-control sys¬ 
tem as a single finite-state machine rapid¬ 
ly gets unwieldy as new systems are added. 
This is especially true for research robots 
that may have radically different sets of sen¬ 
sors and mechanical systems each time they 
are powered up. A more manageable ap¬ 
proach is to create multiple finite-state 
machines. You implement each subsystem 
as a finite-state machine, then set up an 
arrangement that clearly defines how these 
separate state machines will interact. 

One approach to defining hern 1 the state 
machines should interact is the sub¬ 
sumption architecture. The subsumption 
architecture was proposed for robotic con¬ 


trol applications by R.A. Brooks in lL A Ro¬ 
bust Layered Control System for a Mobile 
Robot" {IEEE-Journal of Robotics ami Auto¬ 
mation. VoL RA-2< No. 2, 1986). It has be¬ 
come a popular scheme for robots be¬ 
cause it is flexible, easy to manage, scales 
well for complicated robots, and degrades 
gracefully in the case of sensor failures. It 
can produce surprisingly complicated be¬ 
haviors from small programs, particularly 
when the robot is trying to simultaneous¬ 
ly achieve multiple goals. 

The idea is that each state machine uses 
the relevant inputs (from sensors and in¬ 
ternal states) and continuously generates 
an output of control messages. Then, 
downstream of the control messages and 
before the actual hardware, is an arbitra¬ 


tion mechanism. The arbitrator can be de¬ 
signed in several ways, but it can be 
thought of as a series of enable and in¬ 
hibit nodes (similar to the way tliat actual 
neurons are interconnected; also like real 
neurons, it is the inhibit connections that 
play die major role). These nodes are in¬ 
terconnected in a way that ultimately re¬ 
sults in only one of die multiple incom¬ 
ing control messages actually getting out 
to lire hardware layer. 

Figure 2 illustrates the state machines 
for this robot; 

SENSORS runs ail die robot sensors and 
sets all relevant global variables. This ma¬ 
chine also initializes all the subsystems 
when die robot's “go 11 switch is turned on, 
and stops the robot when the switch is 
turned off. Unlike all die other state ma¬ 
chines, SENSORS is not really part of the 
subsumption scheme, Instead, this ma¬ 
chine provides a central background task 
that assures all the sensors are scanned. 
The IR and contact sensors are essentially 
continuously scanned. Once every six sec¬ 
onds, the sonar is used to look around for 
obstacles. 

WALKER sequences through all six 
robot legs in the currently defined se¬ 
quence, The current sequence is deter¬ 
mined by six execution vectors, each one 
defining which leg to move and the type 
of cycle to execute fur it. The default se¬ 
quence is to move straight forward, but ii 
can be overridden. This machine also has 
an "idle” state that is entered at the end 
of the sixth-leg sequence, before going 
back to die first leg. Usually the machine 
will just transit from die sixth sequence to 
idle to the first sequence. But a general 
robot-shutdown message will cause this 
machine to hold in the idle state until a 
“go” message arrives, at which point it will 



Figure 2: The organization of the 
multiple state machines (in the boxes) 
for the robot in a subsumption scheme. 
Motion- control messages coming into 
the X S” nodes vertically will override a 
message coming into the node from 
the horizontal direction . Note that in 
the absence of any o vemding messages, 
the robot will walk straight forward. 
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WALK_VEC $ DUP IF EXECUTE EXIT ELSE DROP THEN 
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Example 2: The arbitrator. 

(continued from page 56) 
cycle through all the legs again (with a 
walking robot, it is a good idea to have a 
well-defined way to stop walking, or it 
might fall over), 

EXPLORE makes the robot wander 
around in open space until the sonar de¬ 
termines that it is getting dose to an ob¬ 
struction. It then looks for the largest pos¬ 
sible open region to move into. The sonar 
is swept across the field of view r of the 
head in order to find out what is the di¬ 
rection of the largest range. The direction 
that EXPLORE decides to move can de¬ 
termine what six-leg sequence that 
WALKER will use. 

PROXIMIT Y decides upon a course of 
action based on the IR system’s detection 
of an obstacle in the vicinity. If an object 
is detected nearby, the robot turns to walk 
away from it. This machine can override 
the sequence that WALKER would get 
from EXPLORE, 

CONTACT decides upon a course of 
action based on the contact whiskers 1 de¬ 
tection of an object in contact, The be¬ 
havior here is similar to PROXIMITY, ex¬ 
cept that since the robot Ls in contact with 
the object, it backs up several steps be¬ 
fore turning away from the object. This 
machine can override both EXPLORE and 
PROXIMITY. 

During development and testing, you 
cannot just release a half-dozen asyn¬ 
chronous, interacting state machines and 
expect to see a working robot. When de¬ 
signing a system that contains multiple 
state machines, it is important that the in¬ 
dividual machines interact with each other 
in a restricted and well-defined manner 
This makes it easier to develop and test 
each subsystem, since you can work with 
a single state machine at a time. It also 
keeps the coding simpler, since the com¬ 
plications of semaphores or other access 
synchronization schemes are avoided. In 
this robot, for example, only the state ma¬ 
chine WALKER actually moves the legs. 
The other machines communicate with 
WALKER by providing the desired se¬ 
quences of leg movements. This commu¬ 
nication is handled in the arbitration code. 
Once die individual state machines are 
properly running, the overall control sys¬ 
tem can be tested by adding one state 
machine at a time. 


For all its importance, the arbitrator for 
managing the state machines is a small 
routine. It chooses one of several possi¬ 
ble execution tokens (function pointers) 
and runs it. Example 2 is the entire arbi¬ 
trator. This Forth word looks in turn at 
the execution vectors that may be set by 
the machines CONTACT, PROXIMITY, 
EXPLORE, and WALKER, The order in 
which die vectors are tested sets die pri¬ 
ority order. The first non-null vector it en¬ 
counters is executed, then the arbitrator 
exits. When run, each of these routines 
set the six execution vectors for the gait 
sequence used by WALKER, causing the 
robot to start walking with the leg se¬ 
quence determined by die state machine 
with the highest priority. Under ordinary 
circumstances, WALK_VEC contains a 
pointer to the word that defines the gait 
to forward. This means that the default 
behavior of the robot is to walk forward, 
unless it is overridden by a high-priority 
state machine. 

The Future 

One generalization about robots tbit holds 
true is that they are always work in 
progress. For quite some time I was pre¬ 
occupied with just getting this one to walk 
at all. Now I am focusing on the real-time 
process-control-level code that defines the 
robot's basic behavior (this is what 1 have 
described here). 

In the future, there are higher-level 
problems to solve that fall into the domain 
of artificial intelligence. For example: Given 
a map of a room, how does a robot placed 
In an arbitrary location in that room deter¬ 
mine where it is? Even more challenging 
is die question of how it locates itself with¬ 
out a map. Robots certainly are not bor¬ 
ing to work with: There is always a new 
challenge. 
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UNIX Filesystems 
without I-Nodes 


NCPandSMP 
support in Linux 

Volker Lendecke 

A long with nfs, die Linux kernel smbfs 
Mm and ncpfs filesystems make it pos- 
sible to link Linux machines to vir- 
^^tually any file server—from Path- 
works to Windows NT 4.0, From NetWare 
to any NFS server— across a LAN* When 
I was implementing smbfs and ncpfs, 
however, it became dear that Microsoft’s 
Server Message Block (SMB) protocol is 
noL designed to handle UNIX clients like 
Linux, SMB, the protocol that implements 
tile services, is designed for DOS, Conse¬ 
quently, SMB has no notion of an i-node, 
Lhe central structure in every UNIX file¬ 
system implementation. On the surface, 
this would appear to limit Linux's useful¬ 
ness on heterogeneous networks. How¬ 
ever, in this article, I present techniques I 
developed to work around this limitation, 

UNIX Filesystems 

The user’s view of a UNIX filesystem is 
straightforward: Everything is arranged In 
a hierarchy of directories. But this hierar¬ 
chical order does not reflea the filesys¬ 
tem's layout on disk. In reality', all things 
that can be stored in a filesystem—nor- 


Volker, who implemented the ncpfs and 
smbfs plesystems for the Linux kernel stud¬ 
ies mathematics and computer science at 
the University of Gottingen, Germany, fie 
can he contacted at lendecke@matb 
. Unigoetti ngen. de 


mal Hies, directories, named pipes, device 
files, and so on—are represented by 
i-nodes. An i-node stores everything die 
system needs to know about a file— own¬ 
er, size, permission bits, time stamps, and 
pointers to the files data. Basically, the 
i-node is the file. You might expect to find 
the Hie nmm in the i-node, but you wont. 



The name is stored elsewhere. I-nodes 
are arranged in a large array stored at the 
l^eginning of a disk partition, or scattered 
around within die partition. The filesys¬ 
tem can only reference i-nodes via their 
numbers, die indexes into the i-node table. 

Tile illusion of a hierarchical filesystem 
is created by the directory, a special type 
of file. On disk, directories look much like 
norma! files; they have an i-node and data 
bytes. Their data simply consists of a list 
of filenames paired w ith i-node numbers. 
These pairs of names and i-nodes are what 
users see as files. The difference between 
normal files and directories is that users 
are not allowed to access the directories. 
If a program manipulated directories, the 


UNIX system could not maintain its hier¬ 
archical structure. This loose coupling be¬ 
tween a file's name and the file itself is 
the reason you can have two different 
names for a single file. You just create two 
directory entries pointing to the same 
i-node: the names can even be in differ¬ 
ent directories. Moving files in the filesys¬ 
tem is also simple: Create a filename with 
the file’s i-node number in the target di¬ 
rectory and delete the file’s entry Ln the 
source directory, ln short, a file gets an 
i-node number when iL is created* This 
i-node number remains constant during 
the lifetime of the file, no matter where 
you move it in the directory tree. 

This central role of i-nodes can also be 
seen in the implementation of the Linux 
virtual filesystem Cvfs). In fact, the Inode 
Structure (see Figure 1) is the most im¬ 
portant object in the Linux vfs* An i-node 
is read from a table on disk when the cor¬ 
responding file is opened the first time, 
or when the user wants information about 
the file. For example, Lhe command Is- l 
reads every file’s i-node and shows the 
metadata of each file it lists. The i-node 
is written back when the last process that 
accessed the file closes it. All other oper¬ 
ations that can be performed on a file, in- 
dud ing read/writes, refer to die i-node. 

Drawbacks for Linux 

Both Microsoft’s SMB protocol and early 
versions of Novell's NetWare Core Proto¬ 
col (NCP) were designed to redirect all 
file-access functions of die DOS 1NT 0x21 
to the server, lhe native DOS filesystem 
(that is, the FAT system) has no notion of 
i-nodes. FAT does not separate filenames 
from the files themselves. The meta data 
of the files is stored in the directory die 
file resides in together with its name. Be¬ 
cause no i-nodes or i-node numbers are 
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(continued from page 60) 
needed to implement the INT 0x21 inter¬ 
face, neither SMB nor NCP provide i-node 
numbers. A1J that is transferred over the 
network is the pathname of a file. In NCP, 
you can allocate 1-byte handles for parts 
of the path. But these handles cannot t>e 
used as i-node numbers, as they are too 
short and do not uniquely identify a file. 

To implement a filesystem for Linux, you 
have to implement recuijncxief). The up¬ 
per layers of the Linux filesystem (imple¬ 
mented in the linux/fs/*.c source files) band 
an i-node number to this function and ex¬ 
pect the actual file-system implementation 
to fill a prepared i-node structure with the 
values the i-node has on disk. But what 
do you do when you cant ask the file serv¬ 


er to give you “the size of the file with 
i-node 1234" because the server doesn't 
know anything about i-node 1234? That's 
the problem I faced when implementing a 
filesystem for Linux. Clearly, 1 had to find 
a way to fool the Linux kernel 
When writing smbfs and nepfs, 1 had 
to identify all points in the Linux vfs layer 
that rely on the fact that a file is essen¬ 
tially an i-node with a fixed i-node num¬ 
ber. 1 did not expect to find only two vfs 
routines to deal with i-node numbers: 
lookupf) and readjnodef A {created is 
a third, but it works exactly as lookupf) 
does.) The kernel asks lookupf ) for die 
i-node of a file, giving it die filename and 
the directory' to search, lookupf} finds the 
i-node number of the specified file, then 


calls igetf) to read the i-node, igetf) is a 
higher-level function that maintains a 
cache of i-nodes. When it does not find 
the requested i-node in its cache, it calls 
readjnodef) with the i-node number it 
just got from lookupf ). 

So smbfs and nepfs have to make sure 
that lookupf) generates unique i-node 
numbers for all the i-nodes igetf ) holds 
in memory. And lookupf ) needs a way to 
tell read_inode() about the i-node num¬ 
bers it has generated artificially. The Linux 
kernel doesn't care about the i-node num¬ 
ber stored on disk or anywhere else. The 
i-nodes in memory are those that are ref¬ 
erenced as open files from one or more 
processes and are the current working di¬ 
rectory of a process. The numbers of all 
other i-nodes can be randomly chosen. 
The only problem that remains is deter¬ 
mining how the filesystem should choose 
Lhe i-node numbers. 

One solution is to generate them ran¬ 
domly. However, this does not provide 
uniqueness. Another idea is to increment 
a counter whenever an i-node number is 
requested. But as Linux systems are ex¬ 
pected to run for a long time and must 
therefore cope with wraparound, a list of 
numbers in use must be maintained. This 
is inefficient. The fastest solution turns out 
to l>e the simplest: The Linux kernel al¬ 
ready has an extremely reliable number 
generator perfectly suited for this pur¬ 
pose —kmallocf X 

The Jcmo//oc{J Approach 

Normally, when a file-system type is 
added to Linux, the global 1-node struc¬ 
ture is augmented by the fields that are 
needed by lhe new type. This can be 
found in die file linux/indude/fs.h. When 
1 was developing smbfs on the stabilized 
kernel 1,2.13, this was not an option, be¬ 
cause l wanted to run these filesystems 
as modules without kernel modifications. 
Additionally, the structures needed by 
smbfs and nepfs are quite large, and I did 
not want to penalize all other filesystems 
with such a large structure. So I chose to 
store the smbfs/nepfs-specific i-node data 
in a special kmallocf) structure. Now it's 
very fast to find unique i-node numbers: 

I simply use the address of the allocated 
structure. We know this numlx^r is unique 
across all filesystems and it references tire 
corresponding structure without overhead. 

I-node numbers are generated in the 
vfs function lookupf X This function allo¬ 
cates tire special file-system-specific struc¬ 
ture and gives its address as the i-node 
number to lhe kernel routine igetfX igetf) 
finds that the i-node is noi in memory yet 
and calls read_inode with the w anted 
number, readymade is now able to find 
tire file-system-specific data by a type cast. 
The routine pui_inode can reliably kfree 
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You're developing an application to shorten the dreaded 
“paper trail." One problem you have is that many of the 
forms found on these trails require people to sign their 
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sometimes the most important information may be hand 
drawn sketches, such as medical diagrams or traffic 
accident reports, 
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the data T and free the i-node number for 

later use. 

This scheme works well from a kernel 
point of view. The first smbfs implemen¬ 
tation used exactly this mechanism. Then 
the first users complained that the com¬ 
mand pwd could not find the current 
working directory. As the kernel ciid not 
complain about any inconsistent structure, 
the i-node numbering scheme seemed to 
be insufficient. The getwd routine, used 
by pwd, runs as follows: It works its way 
hack to die root directory via the u .," en¬ 
tries of the directories. It stores die i-nodes 
of all the directories it finds on its way to 
the root. Then it reads all the directories 
as Is would, and compares the i-node 
numbers it gets with the ones found on 
the way to die root. Directories are read 
until the current directory is found. Not 
really efficient, hut under UNIX it’s the 
only way to find the path to the current 
directory. 

It should now be dear why the num¬ 
bering scheme I implemented has to fail 
for getivd: Each time a directory is opened 
for reading, a new i-node number is cre¬ 
ated for it. So getwd has no chance to re¬ 
construct the path to die current directory. 
To help getwd, not only do the i-nodes 
used by the kernel need fixed and unique 
numbers, but so do all the i-nodes that 
are parents and grandparents of any 
i-node used, up to die filesystem's mount 
point Tlius nepfs and smbfs build up a 
tree of i-nodes that represents the direc¬ 
tory structure currently in use. When an 
i-node is released (because the corre¬ 
sponding file is closed or die directory has 
been left hy cd, for example), the corre¬ 
sponding file-system structure Ls free l )ed. 
Now the path Lo the root of the mount 
point is traversed and each directory's file¬ 
system structure is released when it is not 
used by other parts of the directory tree. 

By diis enhanced scheme, getwd can be 
satisfied, but some a^yet-unfixed prob¬ 
lems remain. In most cases, when you do 
a Is - i in an nepfs-mounted directory. 


Figure I: The i- node structure. 


each directory entry is assigned the same 
i-node number. This is caused by the ker¬ 
nel mediae routine. When you kfreef) a 
memory area and kmaUoc() a memory 
block of the same size directly after, you 
get the same chunk of memory, resulting 
in identical i-node numbers for all direc¬ 
tory entries. This Ls especially annoying 
because the nfs daemon relies on unique 
i-node numbers across the complete 
filesystem. 

Another command that Ls broken by this 
scheme Ls an implementation of die diff 
command that tests whether the files have 
the same i-node, then refuses to compare 
the files if the numbers are the same, cp 
is another candidate; Sometimes it refuses 
to copy a file over an existing file, because 
it believes both to be die same file. 

Namespaces: NetWare has I-Nodes 

Again, Novell’s NCP protocol was designed 
to implement DOS filesystem functionality. 
But when clients such as OS/2 and UNIX 
were used, NetWare had to cope with dif¬ 
ferent notions of a filename. Although OS/2 
and UNIX allow filenames that don't con¬ 
form to the 8.3 convention, they do not 
agree about ease sensitivity. To lie able to 
cope with these needs, Novell introduced 
the concept of namespaces for NetWare 3 
To handle namespaces, the NetWare core 
protocol was enhanced considerably. 

From die protocol view, the NetWare 3 
filesystem looks similar to UNIX filesys¬ 
tems. NetWare also seems to stone i-nodes, 
wliieh Novell calls “Directory Entries.” The 
Directory Entry Table fulfills die same pur¬ 
pose as UNIX i-node tables. This central 
la hie contains everything relevant about 
a file, such as its size, its owner, and a ref¬ 
erence to the file's data. The NCP name- 
space services let you access entries in this 
table and, thus, individual files by their 
indexes into lids table. These indexes are 
32 bits long and could be called the 
4 i-node numbers” of die files, 

Tlicre is one main directory entry per 
file, the original DOS filename entry. Each 
loaded namespace module adds another 



64 


Dr. Dobbs Journal, February 1997 



























































wwwJnstallshield-com 





(continuedfrontpage 64) 
entry for each file. This is a complete di¬ 
rectory entry of its own and, as such, also 
has a unique 32-bit number. It contains 
the filename according to the conventions 
the namespace expects, along with the 
number of the DOS filename entry. For 
example, the NFS namespace module 
stores up to 255 bytes of the filename, and 
knows that uppercase and lowercase file¬ 
names are different. 

When a file is created, it is always cre¬ 
ated in a special namespace. For exam¬ 
ple, Windows 95 creates all files in the 
OS/2 namespace, giving the file a long 
filename. This file has to lie visible from 
all other namespaces, so the other entries 
have to be created by NetWare itself. Net¬ 
Ware squeezes the name into the 8.3 
scheme required by DOS and creates the 
corresponding DOS directory entry', Win¬ 
dows 95 has to do the same for the WAT 
filesystem* where each file has an 8,3 file¬ 
name in addition to its long filename. 
When a DOS workstation creates a file, 
NetWare does not have to truncate the 
filename, but iL still has to create the ad¬ 
ditional entries in all the namespaces load¬ 
ed, For volumes with many small files, the 
way namespaces are used can cause prob¬ 
lems because lots of additional directory 
entries are allocated. 


You can look at the namespace infor¬ 
mation with the ND1R program that 
Novell delivers with NetWare, When you 
call NDIR with the option /L, it will dis¬ 
play the long filenames that are assigned 
to the files. Window's 95 only shows you 
the 05/2 and DOS namespace filenames, 
but NDIR will also show you the NFS and 
other namespace's filenames. 

The namespace support of NetWare 
now makes it possible to solve the prob¬ 
lem with the i-node numbers, as the pro¬ 
tocol gives you 32- bit directory-entry 
numbers that uniquely identify files and 
directories in the NetWare filesystem. As 
in UNIX filesystems, where i-node num¬ 
bers identify a file only within a filesys¬ 
tem, directory-entry numbers always re¬ 
fer to a NetWare filesystem, a volume. 
There might be two different files in dif¬ 
ferent volumes with the same directory- 
entry number, as it is perfectly possible 
in UNIX. So to provide unique i-node 
numbers for nepfs- mounted directories, 
you have to mount a single volume un¬ 
der one mount point. When you do this, 
the directory-entry numbers that Net¬ 
Ware shows the client via the NCP pro¬ 
tocol are handed to user processes as 
i-node numbers, and user programs can 
rely on the i-node numbers to be unique 
on the complete filesystem. This way, 


the filesystems mounted can be re¬ 
exported by nfs, 

I implemented this as an option only, 
because it is possible that some NetWare 
servers have a lot of volumes, which 
would require many mount points for the 
complete server to be mounted. Tills could 
be expensive, since currently each nepfs 
mount point uses one NetWare user li¬ 
cense, The other issue is that standard 
Linux kernels allow only 64 mount points, 
which could be quickly exhausted. Ifs 
much cheaper to raise the Linux limit than 
the NetWare limit, but ifs inconvenient. 
Consequently, you can still mount all vol¬ 
umes under one mount point, but you 
lose the reexportability. 

The Code 

In general, the techniques I ve described 
here are implemented in the nepfs and 
smbfs kernel code, as well as parts of the 
general Linux vfs layer. More specifically, 
the files dire and inode.c (available elec¬ 
tronically; see “Availability," page 3) are 
excerpts from the nepfs code that illus¬ 
trates the concepts five presented. The lat¬ 
est versions of smbfs and nepfs can al¬ 
ways be found via httpi//www, kki.org/ 
linux-lan/. 

DDJ 
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The comprehensive imaging toolkit 



ADTOOLS is a family of comprehensive imaging tools designed to help 
grammers integrate black & white, grayscale and color images into their 
plications as quickly as possible. LEADTOOLS is a collection of more than 200 
actions, properties and methods, with imaging technology in 10 general categories. 

aiming. Support for both 16 &. 32 bit TWAIN interfaces for driving the most 
polar scanning devices. Developers have the option of using the default TWAIN 
erface of the datasource, or creating 
sir own. Additionally, both native and 
ffeted RAM transfer modes are 
sported, 

>lor Conversion, Expand or reduce an 
age's color depth with multiple 
thering methods (8 available including 
lyd Stein &. Burkes) using various 
lette options (including an auto- 
timized palette, or a user defined 
lette). Images can be separated and/or 
constructed to/from individual color 
anes, such as RGB St CMYK. 

ADTOOLS also supports grayscaling 
d halftoning with rotated screens. 


transparent color and more) rather than the entire bitmap. 

Compression. Includes JPEG, CCITT G3/G4, Huffman, Arithmatic, RLE, LZW and 
LEAD'S own proprietary CMP LEADTOOLS Pro Express delivers the fastest 
software only JPEG algorithms available. The LEAD CMP formats results in smaller 
file sizes and maintains better image quality than industry standard compression 
formats. 

Image Format Import/Export filters. 

Supports over 40 of the most popular 
raster image formats (including 
practically all known “flavors") at 
different pixel depths (1-32 bits) and 
compression options. The new version 
of LEADTOOLS adds Kodak's new 
FlashPix format, and several existing 
formats have been enhanced, (A 
separate license from Unisys is required 
to use the GIF and TIFF LZW code). 

Imaging for the Internet. Specific 
features for the Internet. Support for 
Progressive JPEG, Progressive CMR and 
GIF (interlace, transparency, animation, 
and embedded text). The GIF code has 
also been expanded to read and write the 
rare 2,3,5,6 and 7 bits per pixel formats. 
A FeedLoad function has been created 
to allow image data to be displayed as it 
is being transmitted across the net, 
providing Internet programmers with the 
fastest way to begin painting the clients 
screen. Examples for VB script and Java 
script are included. 


splay. Easy to use, ultra fast paint, 
om, scroll, crop, pan, auto- dithering 
d scaling will make the imaging 
rrion of the programmer’s application 
The 256 shade ScaleToGray 
terpolated) and FavorBIack viewing 
tions will enhance the quality and 
idahility of the display of 1-bit 
cument images. Over 20 paint effects 


Screen capture showing a. portion of ffte mtfess possibilities with new LEADTOOLS version 7 


hiding wipes, blinds, spirals, various blocks, random pixels and lines. 


nnotatlons. Annotations can be added to both black and white, and color images, 
lect from text, highlights, sticky notes, ellipses, free-hand scribbling, redaction 
aLckout), hot-spots, audio, bitmap and text stamps, polygons and many more. Use 
w level or automated mode. 


rage Processing, Over 50 functions, some only found in programs 
ch as Photoshop. Transforms include resize, resample, rotate (.01 
gree), flip, reverse, crop, shear, transpose, auto deskew, and combine 
tmap (with mathematical and Btxilean operations). Filters include 
iderlay, fill, sharpen, blur, brighten, darken, invert t hue and saturation, 
tensity, contrast, gamma correction, histogram equalise, edge detect, 
te detect, emboss, mosaic, posterize, median and noise filters, spatial 
ter (which can be pre-defined or customized), auto deskew, despeckle, 
d more. Drawing, Programmers can access Microsoft Windows GDI functions 
uch as Text Out, BitBlt, Ellipse, and Rectangle), to draw directly to the bitmap's 
rface. Region of Interest. Process only a specific portion of an image (any 
mbination of rectangles, ellipses, rounded-rectangles, freehand shapes, polygons, 


Imaging for Databases. Specific features for the imaging database developer, such as 
Load/Save memory, Load/Save file offset. Visual Basic data binding, 32-bit ODBC, 
and a customized OLE 2,0 in-place server. 

Printing. Performs all image processing necessary to print directly to any Windows 
supported printer, with the ability to print text and multiple images on the same page, 

LEADTOOLS saves programmers time by providing source code 
examples and sample applications, which can be directly added to 
applications. LEAD's mature code is backed up by a 30 day money-back 
guarantee (US &. Canada only) and FREE technical support is available 
via phone, fax, BBS, Internet or CompuServe. For the most current and 
complete technical details, and comprehensive lists of supported file 
formats, image processing Liters, functions, methods, and properties, 
please visit LEAD's web site at http;//wwwieadtoolsxom, or call (704) 332-5532. 

(The ScaleToGray and FavorBIack functions, annotation code, and auto-deskew, 
despeckle, and region of interest features are only available in the Pro Express). 


f Formats 


BMP 

IMG 

MSP 

TGA 

CAL 

I0CA 

PCD 

TIFF 

DIB 

JPEG 

PCT 

VDA 

EPS 

JFIF 

PCX 

VST 

FAX (raw} 

JTIF 

PUG 

WINFAX 

PCX 

LEAS CUP 

PSD 

WMF 

QIF‘ 

MAC 

RAS 

WPG 
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PROGRAMMER'S TOOLCHEST 



Examining C++ 

Program Analyzers 

Finding out how programs really behave 
Scott Meyers and Martin Klaus 


C ++ has a well-deserved reputation 
for power and flexibility. It has an 
equally well-deserved reputation for 
complexity—■ its “gotchas” are legion. 
For example, omitting a virtual destructor 
in a base class typically leads to incom¬ 
plete destruction of derived class objects 
when they are deleted through base-class 
pointers. 

Experienced C++ programmers learn to 
avoid these kind of problematic con¬ 
structs, bur experience should not be nec¬ 
essary ; Troublesome C++ can often lie de¬ 
tected by static analysis, using tools that 
parse and analyze C++ source code. Such 
tools are becoming available, and during 
the summer and fall of 1996, we under¬ 
took an investigation to Identify these tools 
and to assess their capabilities. In this ar¬ 
ticle, we summarize die initial results of 
our investigation. 

We were interested in answering three 
questions. 

First, what tools statically analyze C++ 
programs and issue warnings about 
likely trouble spots? By focusing on 
static analysis, we limited our research 
to tools spiritually akin to lint. We ex¬ 
plicitly ignored tools designed to de¬ 
tect dynamic (run-time} errors, such as 
programs that monitor memory usage 
and report on leaks. Such tools are im¬ 
portant, but they offer functionality that 
complements— noi replaces— static 
analysis. We also ignored tools that fo¬ 
cus on lexical issues (identifier names, 


Scott, a software-development consultant 
and author of Effective C++ and More Ef¬ 
fective C++, can be contacted at smeyers@ 
netcom .com. Martin bolds a degree in 
computer science from the Johannes Ke¬ 
pler University, in Linz , Austria , and can 
be contacted at mklaus@swe. u n i- linz, oqmL 


indentation style); our interest was in 
tools that identify constructs that affect 
program behavior. 

Second, how comprehensive are the 
tools in identifying suspect C++ con¬ 
structs? C++ has many facets, including 
data abstraction, inheritance, templates, 
and exception handling, and we want¬ 
ed to find tools that checked for likely 
errors in many of these areas. A few 
tools checked only the C subset of C++; 
we ignored those offerings. Our inter¬ 
est was in tools for C++ programmers, 
and C++ programmers have different 
needs than C programmers. 

Third, how well do the kxjLs work on 
real programs? Can they parse real 
source code? Do they scale well when 
run on large projects? Are they robust 
enough to handle complex template in¬ 
stantiations, including those generated 
by the Standard Template library? 

In this article, we will address only the 
first two questions* 

Identifying Tools 

When we began this project, we were 
aware of several static-analysis tools for 
C++, but we suspected there were oth¬ 
ers we didn’t know about. Consequent¬ 
ly, we posted a request for information 
to several USENET newsgroups, includ¬ 
ing groups devoted to C++ program¬ 
ming, OOP, and programming on vari¬ 
ous platforms. Based on the responses, 
we ultimately identified the tools dis¬ 
cussed here, 

* CodeCheck From Abraxas Software. 
CodeCheck is a stand-alone tool for 
DOS, Windows, and UNIX that lets you 
use a C-like language to specify what 
kinds of program analysis to perform. 
It comes with several predefined ana¬ 


lysis programs, including some for com¬ 
puting program-complexity metrics and 
identifying non-portable code, 

* C++Experl from Centerline Software, 
Also a stand-alone tool, C++Expert per¬ 
forms static and dynamic analyses of C 
and C++ programs. Its static checks are 
drawn from Scott Meyers’ Effective C++ 
and More Effective C++, and its diag¬ 
nostics contain hypertext links to online 
versions of those books. At this time, it 
supports only UNIX. 

* FlexeLint/PC-Unt from Gimpel Soft¬ 
ware, Another stand-alone too! (the 
name is FlexeLint for UNIX, and PC- 
Lint for DOS, Windows, and OS/2), 
FlexcLint/PC-Lint is perhaps truest Lo 
the classic lint tradition. It can check 
for over 600 potential error conditions 
in C and C++ source code, including 
conditions that affect more than one 
translation unit or that require detailed 
dataflow analysis. 

* Code Ad visor from Hewlett-Packard. 
CodeAdvisor is a pan of HP’s Soft bench 
development environment for UNIX. It 
enforces 23 predefined rules, and you 
can extend its capabilities by coding 
new analyses in C++, then linking them 
in. Source-code information is stored 
in a database, so it is possible to per¬ 
form checks that involve multiple trans¬ 
lation units. 

* Code Wizard from ParaSoft. Code Wizard 
is a stand-alone UNIX tool designed to 
enforce a set of 24 rules selected from 
Effective C++. 

* QA/C++ from Programming Research. 
Another stand-alone tool for UNIX, 
QA/C++ works in two phases. First, it 
examines C or C++ source code and 
stores the results in a database. Differ¬ 
ent Programming Research analysis 
tools may then be run against the 
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(continued from page 68) 
database; these tools generate warning 
messages. There is no database API that 
lets programmers develop their own 
analyses. 

* The Apex C/C++ Development Envi¬ 
ronment from Rational Software. Among 
other capabilities, the Apex environment 
enforces 22 predefined rules for C and 
C++ programming under UNIX, 

To these choices, we added our non¬ 
commercial program, CCEL, purely for 
purposes of comparison, CCEL began 
as a research project on static analysis 
of C++ programs under the direction 
of one of us (Meyers) and was eventu¬ 
ally fully implemented through inde¬ 
pendent work by the other (Klaus), We 
added CCEL to our investigation be¬ 
cause we were familiar with its capa¬ 
bilities and limitations, and we felt it 
would be interesting to compare com¬ 
mercial approaches to our research- 
based initiative. 


Our Approach 

There were three phases in our testing 
process, 

1. We developed a set of benchmark 
rules constraining the structure of C++ 
programs. For example, one rule is that 
all base classes must have virtual de¬ 
structors, We tried to develop a set of 
rules that was representative of the kinds 
of rules that real programmers would 
find useful. 

2. We contacted vendors and asked 
which rules their tool could enforce. 
This information proved useful during 
our empirical tests, because discrep¬ 
ancies between vendor claims and our 
findings often identified subtle differ¬ 
ences between our rules and those en¬ 
forced by vendors. 

3- We developed of a set of sample 
source files seeded with rule violations. 
We ran each tool on each source file to 
see whether the seeded rule violation 
was correctly identified. 


Our results yielded Table 2, which shows 
how well each tool enforced our bench¬ 
mark rules on our benchmark programs. 

Choosing Rules 

There are many ways to compose a set 
of benchmark rules for C++ programs, 
but It is difficult to argue that one set is 
“better" than another. As a result, we 
made no attempt to develop the "best” 
set of rules. Instead, we fell back on the 
fact that one of us (Meyers) lias authored 
two books containing guidelines for C++ 
programming and we chose nearly all 
our rules from those books. 

This approach is not as gratuitous as 
it might appear, Meyers 1 Effective C++ 
and More Effective C++ have been well- 
received in the C++ programming com¬ 
munity, and one or both form the basis 
for many sets of corporate-coding guide¬ 
lines. In addition, these books form the 
basis for at least two of the static-analy¬ 
sis tools in our investigation. Finally, by 
drawing our rules from well-known and 


Rule 

Book 

Item 

Description 

Rule Book 

Item 

Description 

(a> 

i 

E 

1 

Use const instead of ^define for constants at global 

17a 

E 

23 

Have operators like ■+—/* return an object, not a 




and file scope. 




reference. 

2 

M 

2 

Use new-style casts instead of C-style casts. 

17b 

M 

6 

And make those return values const. 

3 

M 

3 

Don't treat a pointer to Deiivedfjas a pointer to Basell 

18 

E 

25 

Don't overload on a pointer and an int. 





19 

M 

33 

Make nonleaf classes abstract. 

<b> 




20 

M 

24 

Avoid gratuitous use of virtual inheritance; that is, 

4 

E 

5 

Use the same form for calls to new and delete , (In 




make sure there are at least two inheritance 




general, this calls for dynamic analysis, but static 
analysis can catch some special cases; calls to 
new in constructors and to delete in destructors. 

<e> 



paths to each virtual base dass. 




for example.) 

21 

B 

29 

Don't return poinfers/references to internal data 

5 

E 

6 

When the result of a new expression in a constructor 


E 

30 

structures unless they are pointers/references to 




is stored in a dumb pointer dass member, make sure 




const. 




delete is called on (hat member in the destructor. 

22 

M 

26 

Never define a static variable inside a nonmember 

6 

E 

9 

Avoid hiding the default signature for operator new 




inline function unless the function is declared 




and operator delete. 




extern. (Note: In July 1996, changes to the 
nascent standard for ANSI/ISO C++ obviated the 

(c) 







need for this rule, at least on paper. However, toe 

7 a 

E 

11 

Declare a copy constructor for each class declaring 




need still exists in practice, because many 




a pointer data member. 




compilers continue to heed the older rules that 

7b 

E 

1 

Declare an assignment operator for each class 




can lead to duplicated variables in inline 




declaring a pointer data member. 




nonmember functions.) 

B 

B 

12 

Initialise each class data member via the member 

23 



Avoid use of “ ..” in function parameter fists. 




initialization list. 





9 

E 

13 

List members in a member initialization list in art 







order consistent with the order in which they are 

24 


3 

Don't redefine an inherited nonvirtual function. 




actually initialized. 

25 

E 

38 

Don't redefine an inherited default parameter value. 

10 

E 

14 

Make destructors virtual in base classes. 

<g> 




11 

E 

15 

Have the definition of operator- return a reference to 







*ihis. (Note: This says nothing about declarations.) 

26 

M 

5 

Avoid use of user-defined conversion operators 

12a 

E 

16 

Assign to every local data member inside operators 




(nonexplicii single-argument constructors and 

12b 

E 

16 

Call a base class operator from a derived class 




Implicit type conversion operators). 




operator =. 

27 

M 

7 

Don't overload &&, 11, or 

Make sure operators ++ and — have the correct 

12c 



Use the member initialization list to ensure that a 

28 

M 

6 




base dass copy constructor is called from a 




return type. 




derived class copy constructor. 

29 

M 

6 

Use prefix ++ and — when the result of the 

13 



Don’t call virtual functions in constructors or 




increment or decrement expression is unused. 




destructors. 

30 

M 

22 

Declare op= If you declare binary operator (for 

(d) 







example, declare += if you declare +, declare 
-* if you declare One way to satisfy this 

14 

E 

19 

Use nonmember functions for binary operations like 




constraint is by providing a template that yields 




/* when a class has a converting constructor. 




the appropriate function, 

15 

E 

20 

Avoid public data members. 





16 

E 

22 

Use pas s - by- refAo cons t instead of pass-by-value 







where both are valid and the former is likely to be 

31 

M 

11 

Prevent exceptions from leaving destructors. 




32 

M 

13 

Catch exceptions by reference. 


Table 1: Benchmark rules, (a) General; (h) use of new and delete; (c) constructors/destructors/assignment; (d) design; 
(e) implementation; (f) inheritance; (g) operators; (h) exceptions. 
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easily accessible sources, we avoided the 
need to explicitly justify individual rules 
in our benchmark set. Instead, the justi¬ 
fication for nearly every rule is available 
in the books, and we simply refer to the 
appropriate book location as the ratio¬ 
nale for each rule. 

We chose 36 rules divided into eight 
categories; see Table 1. Each rule begins 
with its "Rule" number, followed by a ref¬ 
erence to either Effective C++ (E) or More 
Effective C++ CM), Next is a reference to 
the book "Item 11 number from which the 
rule is derived. The text of the mle is of¬ 
ten different from the text of the book 
Item, because the book Items tend to be 
worded too generally to be checked. 

Some of the rules may seem contro¬ 
versial, especially in light of the C++ 
found in many popular class libraries. 
Rule 15 (no public data members) is 
widely violated in the MFC, for example, 
while almost no library adheres to Rule 
19 (make all nonleaf classes abstract). 
With the exceptions of Rules 13 and 23 
(which we hope are self explanatory), 
Effective C++ and More Effective C++ of¬ 
fer firm technical foundations for each 
rule. We believe it is therefore important 
that programmers be able to enforce 
those constraints, even if the majority of 
programmers choose not to. Furthermore, 
our decision to include rules that are 
commonly violated helps us evaluate the 
effectiveness of the tools’ filtering capa¬ 
bilities, (We do not report on tills aspect 
of the tools in this article, but it is an im¬ 
portant consideration in the practical ap¬ 
plication of any tool.) 

Benchmork Programs 

For each of our 36 rules, we developed a 
source file seeded with a violation of the 
rule. We then executed each tool on each 
source file to see if the tools correctly iden¬ 
tified the seeded errors. These source files 
were truly trivial—many were under ten 
lines long. Our goal was not to provide a 
realistic test of the tools—just to see 
whether or not the tools could identify rule 
violations in the simplest of cases. (Some¬ 
times, tills backfired and yielded mislead¬ 
ing results ) Listing One (listings begin on 
page 87) is the source code for the file 
used to test Rule 20. 

Compilers versus Special Tools 

Several people responded to our request 
for information on static-analysis tools by 
remarking that they found little need for 
such tools. Instead, they relied on com¬ 
pilers to flag conditions that were likely 
to lead to trouble (“I find GNU G++ with 
— ansi - pedantic -Wall -O flags useful 
was a typical comment). 

In fact, die GNU compiler was singled 
out as being especially good at warning 


about troublesome C++. This piqued our 
curiosity about compiler warnings. How 
many of our candidate rules would com¬ 
pilers identify? 

To find out, we submitted our bench¬ 
mark programs to five compilers, in each 
case enabling as many warnings as pos¬ 
sible. As Table 2 shows, the results were 
disappointing. Even G++ identified, at 
most, 2 of the 36 rule violations, and three 
of the compilers identified none. This con¬ 
firmed our impression (based on our ex¬ 
perience as C++ programmers) that while 
compilers—at least the compilers with 
which we have had experience—are 
good at many things, identifying legal, but 
potentially troublesome, C++ source code 
is not one of them. 

Specifying Constraints 

The tools in our study let you specify what 
conditions to check for in one of two ways. 
Most tools follow the lint model, whereby 
the tool is created with the ability to en¬ 
force some set of predefined constraints, 
and you turn these constraints on or off. 
There is no way to extend the capabilities 
of such tools. For example, a tool Is either 
capable of detecting that an exception may 
leave a destructor (Rule 31) or it’s not. If 
it’s not, there is no way for a tool user to 
add that capability; 

A different approach — employed by 
Abraxas’ CodeCheck, HP’s Code Ad visor, 
and our CCEL— is to provide tool users 
with a language in which to express con¬ 
straints of their own. Such tools may or 
not be useful "out of the box” (it de¬ 
pends on the existence and utility of pre¬ 
defined rule libraries), but can be ex¬ 
tended to cheek for new% user-defined 
conditions. This approach is more pow¬ 
erful, but, as in the case of C++ itself, 
complexity often accompanies powder; 
the power Is inaccessible until you have 
mastered the constraint-expression lan¬ 
guage. Furthermore, die addition of user- 
defined constraints may affect an analy¬ 
sis tool’s performance, because enforcement 
of such constraints may require arbitrary 
amounts of time, memory, or other re¬ 
sources. 

We made no attempt to master the var¬ 
ious constraint-expression languages used 
by the different cools, but the examples 
we saw (see the accompanying text box 
entitled "Constraint Expression Lan¬ 
guages") reinforced the lessons we learned 
during the design and implementation of 
CCEL—it’s hard to design a language for 
expressing constraints on a language as 
feature-filled as C++, and such a constraint 
language is nontrivial to learn. Abraxas, 
for example, reports that It takes between 
three and six months to become proficient 
in the CodeCheck constraint language. 
Most Abraxas customers w r ant to hire spe¬ 


cialists to compose rules instead of hav¬ 
ing to learn to write the rules themselves. 

Most programmable tools attempt to of¬ 
fer the best of IxJtli w orlds by shipping a 
set of predefined rule libraries that check 
for commonly desired constraints. This 
eliminates die need to w rite rules to cov¬ 
er common constraints. 

Results and Discussion 

Table 2 presents the results of running die 
various tools on the collection of bench¬ 
mark programs. Several features are of in¬ 
terest. First, no tool was able to enforce 
all of our 36 benchmark rules, not even 
the tools supporting user-defined con¬ 
straints. Thus, even the best of tools cur- 
ready available offers only partial cover¬ 
age of C++, This is especially noteworthy 
because our benchmark rules themselves 
failed to exercise all major language fea¬ 
tures; templates are a particularly obvious 
omission. 

Second, the number of benchmark rules 
that can be enforced without program¬ 
ming (out of the box) is, at most, 17 of 
36. (CCEL supports 19, but CCEL is a re¬ 
search project, not a commercial tool.) If 
we speculate that our set of benchmark 
rules is somehow representative of the 
kinds of constraints real programmers 
might w r ant to enforce, this suggests that 
current tools cover, at best, only about half 
of those constraints. Of course, automatic 
enforcement of half a set of requirements 
is better than no enforcement at all, but 
the data in Table 2 suggest that there is 
much room for increased language cov¬ 
erage by static-analysis tools for C++. 

Third, it is not uncommon to have sub¬ 
tle mismatches between a benchmark rule 
and the conditions detected by die analy¬ 
sis tools, [n mast cases, this is an outgrowth 
of the vendors’ attempts to avoid generat¬ 
ing warning messages when no truly harm¬ 
ful condition exists. For example, consid¬ 
er Rule 10: “Make destructors virtual in 
base classes.” Many programmers consid¬ 
er this rule too aggressive, and a common 
alternative form of the .same rule is; “Make 
destructors virtual in classes containing vir¬ 
tual functions.” This form has die advan¬ 
tage that no virtual table pointer is added 
to a class simply to satisfy the rule. (This 
is the rule variant that’s employed by the 
GNU C++ compiler, HP’s GodeAdvlsor, and 
Programming Research’s QA/C++.) 

The motivation for this rule (in any 
form) is that Listing Two is generally hann- 
ful if the base class lacks a virtual de¬ 
structor. In truth, listing Two is only harm¬ 
ful if one or more of the following 
conditions holds; 

* D has a destructor. 

* D has data members that have de¬ 
structors. 
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• D has data members that contain data 

members (that contain data members, 

and so on) with destructors. 

At least one tool vendor attempts to is¬ 
sue a diagnostic only if these more strin¬ 
gent conditions exist, and the conditions 
do not exist in our test program (Listing 
'Lhree), F 11ie tool in question thus issues 
no diagnostic on our sample program, but 
if class Derived were nontrivial, the tool 
might issue a warning. 

This more precise analysis should be 
beneficial for users, because a diagnostic 
should be issued only if a problem truly 
exists. However, the rules of C++ can be 
both complicated and unintuitive, and their 
subtlety can cut both ways. In the ca.se of 
line vendor attempting to check tor the more 
detailed conditions outlined earlier, the test 
for data members with destructors in the 
derived class was omitted, i fence, though 
the tool avoids issuing warnings in harm¬ 
less cases, it also avoids issuing warnings 
in some harmful, but rare cases. These are 
precisely the cases in which static-analysis 
tools that correctly understand the detailed 
rules of C++ are most useful! 


Another tool had trouble issuing correct 
diagnostics when compiler-generated func¬ 
tions— default constructors, copy con¬ 
structors, assignment operators, and 
destructors (especially derived-dass de¬ 
structors)— were involved. Because of the 
minimalist nature of our test cases, our 
programs had many instances of such 
functions; this led to incorrect results from 
some tools. 

Whether such shortcomings would 
cause problems when the tools are ap¬ 
plied to real programs is unknown, but it 
hints at a deeper problem we found: Ven¬ 
dors don't seem to understand the sub¬ 
tleties of C++ as well as they should. We 
believe that vendors of C++ analysis tools 
must understand C++ as well as compil¬ 
er vendors, but based on our experience 
with die tools in this study, we must re¬ 
port that such expertise cannot yet be tak¬ 
en for granted. 

Caveats 

While Table 2 provides insight into tire state 
of existing lint-like tools for C++, it is im¬ 
portant to recognize what it does not show, 
We were interested only in the capability 


of such tools to handle the “++ n part of 
C++, but most of the tools also provide sig¬ 
nificant other capabilities. 

Most tools also check the 4 C n part of 
C++, some quite extensively. This can be 
useful. By limiting our tests specifically to 
C++ capabilities, we were able to sharpen 
our focus, but we also screened out the 
majority of some tools' functionality. 

Many tools offer stylistic and lexical 
checks in addition to the semantic issues 
we looked at. For example, if you wish 
to ensure that classes never use the de¬ 
fault access level of private, but instead 
declare it explicitly, at least one tool will 
note v iola tions of tJ i a i constra ini 
Some tods offer complementary ana¬ 
lyses in addition to checking coding 
“style." For example, Programming Re¬ 
search's QA/C++ can calculate various pro¬ 
gram- complexity metrics. 

In addition, our set of bencliniark rules 
was far from exhaustive. Some vendors 
check for C++-specific conditions we 
didn't consider; Table 2 says nodiing about 
such capabilities. 

All this is to say that Table 2 is anything 
liut a buyer’s guide. Furthermore, there 
are many nontechnical characteristics of 
analysis tods you should consider before 
deciding which, if any, is suitable for your 
circumstances. The following questions 
come to mind: 

* 1 low' easy is it to install, configure, and 
use the tool? These factors are especially 
important for tools with equivalent (or 
dose to equivalent) capabilities. For ex¬ 
ample, GImpel Software’s FlexeLint and 
Productivity Through Software's ProLint 
use the same underlying analysis en¬ 
gine, but offer quite different user in¬ 
terfaces. 

* How easy is it to filter out unwanted 
diagnostics? The traditional Achilles 
Heel of lint-like tools is an unaccept¬ 
able signal-to-noise ratio, so it's im¬ 
portant that users be given fine-grained 
control over what code is analyzed and 
which diagnostics appear. In fact, some 
vendors deliberately avoided offering 
checks for some conditions (for ex¬ 
ample, the use of preprocessor macros 
to define constants-—our Rule 1) be¬ 
cause they Felt it would be more both¬ 
ersome than useful to their customers. 
(Respondents to our newsgroup post¬ 
ings indicated that a had signal-to- 
noise ratio is a continuing problem, 
even with some of the tools consid¬ 
ered here.) 

* How robust and up-to-date is the C++ 
parser? To be maximally useful, a C++ 
analyzer must parse exactly the same 
language as the compileds) you use. It's 
particularly frustrating if die analyzer re¬ 
jects code your compiler accepts. 


Constraint Expression Languages 


A s an example of the different ways 
in which constraints on C++ pro¬ 
grams may be expressed, consid¬ 
er our Rule 10. In English, the constraint 
is: “Make destructors virtual in base 
classes." When this constraint is for¬ 
malized and made amenable to en¬ 
forcement by computer, it quickly be¬ 
comes more complicated. 

CCEL offers a fairly succinct way to 
express this constraint, because CCEL 
was specifically designed to make the 
expression of constraints like this 
straightforward. Still. CCEL’s formal na¬ 
ture makes it wordier than English. (It 
also makes it more precise.) Example 1 
illustrates Rule JO in CCEL. 

CCEL embodies a declarative approach 
to the specification of constraints: You 
specify what you want to enforce, not 
how to enforce it. This CCEL constraint 
can be read like this: “For all classes B 
and all classes D that inherit from B. B 
must have a member function m such 
that m is a destructor and m is virtualT 


Compared to CCEL, the program¬ 
mable analysis tools we investigated 
are long winded. That's because they 
employ a procedural approach to con¬ 
straint specification; You write code 
specifying how to go about detecting 
violations of the constraints you define, 
In practice, a procedural approach is 
more powerful, but it’s also more com¬ 
plicated, 

For example, Abraxas offers a C-like 
programming language for new con¬ 
straints, HP’s CodeAdvisor uses C++ 
as an extension language and new 
constraints are implemented via class¬ 
es inheriting from the predefined Rule 
class, These classes are then compiled 
and linked to a run-time library. Cen¬ 
terline plans a similar extension of 
C++Expert. 

Implementations of Rule 10 in all of 
these tools are available electronically 
(see "Availability." page 3). 


—S.M, and M.K. 


BaseClasEDtqr { 

Class E: 

Class P 3 D,is_descendant(B); 

Assert{MemberFunction B: :m; 3 m.naraeO -- ' 1 ~ <, + B.nauie() && m, is.virtualO) : 

it 


Example 1: Rule 10 in CCEL. 
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Mote i Waning issued that functions containing Slate variables aro not expanded Wine. 

Note 2 Will note a nonvirtual destructor in classes with virtual functions. 

Note 3 Vendor claims the condition will be delected, but tests exposed at least ooe failure to do so, 

Note 4 A diagnostic fe issued only uhen the calls to new and delate are within the same function. 

Note 5 Erroroneousty diagnosed an error in a valid source He. 

Note 6 Doesn't diagnose this particular condition, but uses similar heuristics to identify classes where assignment operators and copy constructors should be declared. 
Note 7 A diagnosis ts issued that hints at the problem, but (he problem is nol directly identified. 

Note 8 A diagnostic ra issued only whan the member is “initializstf' in the body of the constructor. 

Note 9 (TNs note is not used,} 

Note 10 Allempts to warn about Ihts only when Ihe condition would cause a run-time problem, but tesls showed at least one failure to do so. 

Note 11 The vendor claims that users can program the loot to detect violations of the constrain!, but technical support was unable to describe how when asked. 

Note 1 2 A constrain! to enforce the role can be written, bul the HP parser doesn't yet support ‘expHc#.’ 

Note 13 This condition isn't delected, but use of uninitialized memory is dynamically detected, 

Note 14 -Rcplus used, but Abraxas describes this as a tutorial end example li!a n nol designed for production use. 


Table 2: Results of submitting sample programs to tools: - tool failed to detect violations of this rule on our benchmark programs; X, tool detected the seeded rule violation 
in our benchmark programs; Q vendor claims tool will detect violations of this rule ; but we were unable to acquire a copy of the tool to test claim: CD, imidor claims tool 
will detect violations of this rule dynamically, but we were unable to acquire a copy of the tool to test claim ; CWPJ imtdor claims users can program the tool to detect 
violations of the constraint. We did not test the claim , ^ 
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(continued from page 72) 

• Can the tool handle large projects— 
those with multiple libraries and hun¬ 
dreds or thousands of source files? Based 
on the responses we got from our 
USENET postings, the answer too often 
is that it cannot, 

• Is the documentation complete, accu¬ 
rate, accessible, and comprehensible? 

• Does the vendor offer adequate customer 
service, including technical support? 

• How well established is the vendor? Is 
the vendor likely to continue to support 
the tool for years to come? 

Our study considered none of these 
issues. 

Finally, it is important to remember 
that Table 2 is based on tests we per¬ 
formed in August/September 1996, Vir¬ 
tually all of the tools we examined are 
under active development, so it’s likely 
that new versions exist even as you read 
this report. For example, we know r that 
Abraxas is currently beta-testing a set of 
predefined constraints derived from ma¬ 
terial in Meyers' books, and CenterLine 
and Rational are planning upgrades to 
C++Expert and Apex, respectively, Lhat 
will allow users to define new con¬ 
straints. Other vendors are similarly ac¬ 
tive, Table 2 represents a mere snapshot 
of the commercial state of the an in 
September 1996, 

Summary 

A number of analysis tools are now avail¬ 
able that read C++ source code and warn 
about possible behavioral problems. They 


cover varying aspects of C++, though none 
offers truly comprehensive coverage of the 
language. Based on simple tests, we be¬ 
lieve that many dangerous C++ constructs 
can be detected, though the complexity of 
C++ leads to incorrect behavior on the part 
of some tools, especially where compiler- 
gen era ted functions are concerned. C++ 
analysis tools are under active develop¬ 
ment, and it is likely that the data in this 
article fails to accurately reflect the current 
capabilities of the tools we examined. If 
you are interested in static-analysis tools 
for C++, we encourage you to contact the 
vendors, conduct your own tests, come to 
your own conclusions—then share them 
with us. 
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For More Information 

ParaSoft Corp. 

2031 South Myrtle Avenue 
Monrovia, CA 91016 
818-305-0041 

http://www. pa rasoft com/ 


Abraxas Software 
5530 SW Kdiv Avenue 
Portland, OR 97201 
503-244-5253 
http://www. ahxsoft. com/ 

Centerline Software 
10 Fawcett Street 
Cambridge, MA 02138-1110 
617-498-3000 
http ://www. center] irie.com/ 

Gimpel Software 
3207 Hogarth Lane 
Col lege vt lie, PA 19426 
610-584-4261 
http://www,gimpeLeom/ 

Hewlett-Packard 
19410 Homestead Road 
Cupertino, CA 95014-0604 
408-725-8900 

lmp://www,hp.coni/sesclC/u' 


Productivity Through Software Inc. 

555 Bryant, Suite 555 

Pab Alto, CA 94301 

415-934-3200 

http://www. pts. co.uk/ 

Programming Research Ltd, 

1/11 Molesey Road, Hersham 
Surrey KT12 4RH, UK 
+ 44-1932-88 80 80 
http ://www, prqa.co. u k/ 

Rational Software Corp. 

2800 San Tomas Expressway 
Santa Clara, CA 95051-0951 
408-496-3600 
lmp://www\ratioraLcom/ 


Need a 
Modem 

Parsing 

Tool?? 



1 highly recommend Visual Pars 
Larry O'Brien, Software Develo 


Visual Parse+ + is the only tool 
that applies the techniques of visual 
programming and RAD (Rapid 
Application Development) to lexing 
and parsing technology. Why settle 
for a text-based tool when you can: 
f See the Syntax Tree 
f See the Parsing Stack 
f See Con Diet Trace Trees 
t See Grammar Rule Matches 
t See Errors and Error Recovery 
t See Regular Expression Matches 
t See the Flow of your Input Data 
t Work in one tenth the time l 

When your design Is finished, write 
your application using: 

C/C++: full support for VC++ 
1.5, 2.x, 4.x and BC+ + 4.x (16 and 
32 bit). Comes with a complete, 
100% portable class library (Unix, 
Mac, OS/2) 

visual Basic: use the powerful 
parsing VBX/OCX 

Delphi: native Delphi support! 

Comes with drop-in parsers for 
HTML, SQL, RTF, Modula 2, C, 
C++, CONFIG.SYS, and more. 

Big claims? We back them up with a 
60-day money back guarantee. If it 
doesn't do what we say, send it back! 

Intro price: $299! 


Call (800) 988-9023 


a-ndStone 



950 Shore Crest Road 
CarlsbatL CA 92009 
Phone: (dll 9) 929-9778 
Fax: (619) 929-9848 
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PROGRAMMER'S TOOLCHEST 



Testing Testers 

Selecting the right tool 
for the right job 

Ron van der Wal 


I n an ideal world, software development 
would progress smoothly from re¬ 
quirements to completion, In the real 
world, however, errors creep in. To get 
them out, various automated checking 
tools are available, including Bounds- 
Checker, CodeGuard, Purify, PC-lint, and 
others. Basically, these tools watch your 
program in operation and report on er¬ 
rors. (The exception is PC-lint, which op¬ 
erates on your source code.) Which check¬ 
ing tool is best for you? Every vendor 
claims its tool is the best—and they all 
have tht i numbers to prove it. So what are 
you to do? 

To answer this question, 1 worked with 
a number of tools in my development ef¬ 
forts, using a number of tests—some from 
vendors, some of my own (mine are avail¬ 
able electronically; see "Availability," page 
3)—to compare the tools. What I dis¬ 
covered (not surprisingly) Is that each tool 
has strengths and weaknesses. No single 
checking tcx>l is ideal in all respects, but 
neither arc there any bad tools among the 
crop that I examined-—it just depends on 
what you're looking for. 

The testing tools I examine here fall into 
two categories—static and dynamic. Stat¬ 
ic testers do their job without executing 
die program under test, and dynamic 
testers monitor its execution (for more in¬ 
formation, see the accompanying text box 
entitled “Static and Dynamic Testing*), PC- 
lint Is the only static tester in the roundup; 
all others are dynamic testers. Dynamic 
testers use several different methods to 
monitor the program, but one way or an¬ 
other, they all insert some sort of probe 
into your program. These probes are 
known as “instrumentation/ and many dif¬ 
ferences between die tools can l>e traced 
back to their instill mentation method (see 


Ro n . au thor of the Ta rma Simulation 
Framework, can be contacted at tarma® 
pi.net. 


accompanying text box entitled “Instru- 
mentati on Techn iques 11 ). 

BoundsChecker 4.0 Professional 

Nu Mega's BoundsChecker is probably the 
best-known tod in its class. The Bounds¬ 
Checker family started several years ago 
with tools for DOS and 16 -bit Windows; die 
most recent versions (die ones examined 
here) target Win32 platforms. In particular, 
I tested BoundsChecker 4.0 Professional 
for Windows NT and its companion for 
Windows 95. 

BoundsChecker can lie used as a stand¬ 
alone program loader and tester If you 
don't do anything else, BoundsChecker 
will intercept calls to Windows API func¬ 
tions and heap-related C and C++ runtime 
library functions while your program is 
mnning and record invalid parameters, in¬ 
valid pointers, error-return codes from API 
functions, and a general event trace. At 
program termination, memory and other 
resource leaks are reported. If a problem 
is detected, BoundsChecker by default 
pops up a dialog box that shows the type 
of error, its location (if source debug in- 
formation Ls available), and several options, 
among which are the abilities to suppress 
further reporting of the same error and to 
break into a debugger at the error loca¬ 
tion, All error reports are collected in 
BoundsCheckebs log window, which can 
be saved at die end of die session. Ai s a fi¬ 
nal option, BoundsChecker can perform 
a Win32 compliance check, which signals 
die presence or use (your choice) of Win32 
API functions that differ among Win32s, 
Windows 95, and Windows NT. 

If Microsoft Visual C++ 4,0 (and later) 
is your C++ compiler, you can take ad¬ 
vantage of BoundsChecker 1 s Integrated 
Debugging mode. In this mode, you don’t 
need the BoundsChecker program load¬ 
er but can instead use the Visual C++ 
workbench's debugger to run your pro¬ 
gram. The rest is the same; Bounds¬ 


Checker sits in the background and pops 
up if it detects a problem* The resulting 
error log ends up in the Visual C++ Out¬ 
put window, under a separate Bounds¬ 
Checker tali. 

All this is included in the Standard edi¬ 
tion of BoundsChecker If you have the 
Professional edition, you can improve er¬ 
ror detection by adding compile-lime in¬ 
strumentation (CTI). In essence, this is a 
preprocessing step on your C and C++ 
source code that adds numerous checks 
to pointer operations and the like that help 
detect several additional types of errors. 
Once the extra instrumentation is in place, 
operation is identical to the Standard edi¬ 
tion. One tiling to be aware oh CTI is cur¬ 
rently supported only in conjunction with 
Microsoft Visual C++ (4.0 and later). 

BoundsCheckebs operation can be 
tweaked extensively through options ac¬ 
cessible from its program loader (or 
through the Visual C++ workbench) and 
by means of configuration, suppression, 
and library specification files Furthermore, 
version 4,0 adds the ability to specify cus¬ 
tom validation modules, which lei you add 
virtually any kind of checking or logging, 
using the same routines that Bounds¬ 
Checker uses internally for the built-in 
checks?. 

CodeGuard 32/16 

Borland's CodeGuard is a companion tool 
to Borland's family of C++ compilers. It 
made its debut as a 16-bit add-on tool for 
Borland C++ 4,3 and is now pan of the 
Borland C++ 5,0 Development Suite, with 
16- and 3 2-bit versions covering both 
Win 16 and Win32 programs (DOS pro¬ 
grams are not supported by CodeGuard). 
During testing, l concentrated on the 32- 
bit version. The 16-bit version is similar, 
with the exception of a number of poi nt¬ 
er checks that rely on the 32-bit CPU 
model and are therefore not available in 
16 -bit mode. 
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Stake your Claim 
in the New World at 

World Movers 

The VRML 2.0 Developers' Conference 
January 30-31,1997 at the ANA Hotel, San Francisco 
Register Now at www.worldmovers.org 



Secure your place at World Movers— 

the VRML 2.0 event of the year. If you're 
a professional Web content creator or 
Web application developer—you won't 
want to miss this event. Come join 
the VRML revolution and help build 
the 3D Web. 

At the conference you can join in 
expert panel discussions on VRML 2.0 
issues such as multi-user worlds, using 
Java with VRML, deploying 3D games on 
the Net,optimizing VRML and adding life 
to your animations. You'll discover the 
right tools for efficient modeling and 
how to integrate VRML, HTML, Java and 


other digital media. And,you can attend 
The VRML Boot Camp—a chance to get 
in on the ground floor of a new industry, 

In addition to the wealth of innova¬ 
tive sessions and the insight from indus¬ 
try luminaries,you'll discover exciting 
tools and technology from some of 
today's most influential companies 
developing for the Web. 

So register for World Movers— 

The VRML 2.0 Developers' Conference 
at www.worldmovers.org or call 
1-800-488-2883. If you don’t stake your 
claim now, the new world of VRML 2.0 
will leave you behind. 


Our advisory board, some of the visionary 

leaders in the VRML industry, includes 

* Rikk Carey, co-author and co-architect 

of VRML 2.0 and an original member of the 
VRML Architecture Group, 

- Benjamin Fein man, technical evangelist, 
Netscape Communications Corporation, 

* David Frerichs, chairman, VRML product 
manager, Silicon Graphics, 

1 Konstantin Guericke, vice president of sales 
and marketing for Black Sun interactive, 

* Mitra, chief technology officer at ParaGraph 
International and a co-architect of VRML 2.0, 

* Tony Paris!, chief technology officer, 
Intervista Software, and co-author of VRML CO, 

* Mark Paste, co-author of VRML 1.0 and an 
original member of the VRML Architecture 
Group and author of VRML:Browsing and 
Building Cyberspace, 

■ James Waldrop, technical director, 

Construct Inc 


Hosted by: 


Co-sponsor: Publication Co-sponsors: 


Seybold 


intervista 


PCWEEK ilia- 


NETSCAPE 


CIRCLE NO. 336 ON READER SERVICE CARD 
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Once installed, CodeGuard becomes 
part of the IDE, In fact, die C++ compil¬ 
er knows enough about CodeGuard to 
insert the CodeGuard instrumentation 
code into the object code of C and C++ 
programs during compilation if the right 
options are given. With instrumentation 
code in place, the program is then linked 
to the CodeGuard library, which inter- 
cepts both C runtime and Windows API 
functions- At runtime, the CodeGuard DLL 
tracks pointer usage with the aid of the 
instrumented code, and API usage 
through the intercepted entry points. If 
an error is detected, CodeGuard by de¬ 
fault pops up a message box (no specif¬ 
ic information—just that an error was 
found) and writes a report to a tog file. 
If die program is run from witliin die Bor¬ 
land IDE or Turbo Debugger, a break¬ 
point will occur, and the debugger will 
become active. At program termination, 
a leak search is performed and added to 
the log file. If so configured, CodeGuard 
will also add a function-call profile to the 
log file containing the number of times 
each intercepted function is called. The 
whole process from compilation onward 
can also be performed from the com¬ 
mand line, in which case CodeGuard 
does report and log errors, but no break¬ 
points will occur 

CodeGuard r s operation Ls configurable 
through a separate setup program (ac¬ 
cessible through the IDE) or by directly 
editing a configuration file that records 
the options that apply to a given exe¬ 


cutable. Through this configuration file, 
you can determine the amount of mem¬ 
ory and pointer validation, the details of 
API checks, and set several other options. 

Purify 4.0 NT 

Pure Atria's Purify has been known for 
several years as a UNIX tool. With Purify 
4.0 NT it is available for PC platforms, but 
initially only if they run Windows NT. 

Purify operates as a program loader and 
tester. For instrumentation, it uses a tech¬ 
nique called “Object Code Insertion" 
(GCI), which takes an executable mod¬ 
ule (either .EXE or .DLL), analyzes the 
code within, and inserts additional in¬ 
structions that check pointers and mem¬ 
ory accesses. This happens for each mod¬ 
ule that is used by a given program, 
including third-party modules such as sys¬ 
tem DLLs. (Don't worry, the original mod¬ 
ule is never modified; Purify works with 
instrumented copies.) As a result, every 
piece of code that is executed by your 
program will be instrumented, regardless 
of its origin. However, OCI alone does 
not catch all errors; to detect memory 
leaks, Purify uses an approach that re¬ 
sembles the "mark” phase in "mark and 
sweep” garbage- collection schemes, It re¬ 
cursively follows potential pointers to 
identify reachable heap blocks. Any blocks 
that cannot be reached at all are then con¬ 
sidered leaks; any blocks dial have point¬ 
ers into them, but not to their start ad¬ 
dresses, are reported as potential leaks. 

After the instrumentation phase, Purify 
runs die instrumented program and tracks 


all detected errors. The error reports are 
collected in a log view, which is updated 
while the program is running. Unlike the 
other dynamic testers, Purify does not pop 
up a message box when it detects an er¬ 
ror, but it can be configured to cause a 
debugger breakpoint in Lhose cases. 

Purify configuration is done from with¬ 
in the loader. Apart from settings that de¬ 
termine features such as the size of the 
deferred free queue and whether memo¬ 
ry and handle leak checks are performed 
at program termination, Purify T s output 
can he tailored to your needs through the 
use of filter sets. As its name implies, a 
filter determines which types of error re¬ 
ports are shown and which aren't. This is 
purely a display matter: The unwanted 
error reports are hidden, but remain pre¬ 
sent in Lhe overall log. A sophisticated fil¬ 
ter manager makes it easy to create and 
combine different filters and share them 
across programs. Finally, the Purify run¬ 
time support can be accessed through a 
documented API, which allows your pro¬ 
gram to communicate with Purify while 
it is being tested—for example, to test 
for new memory leaks created between 
two locations in your program. Inciden¬ 
tally, this is the only case for which you 
need to recompile and link your source 
code in order to work with Purify. 

PC-Iint 7,0 

GimpeJ Software's PC-lint is the only test 
tool examined here that performs a stat¬ 
ic analysis of your program to detect po¬ 
tential problems. It is inspired by the well- 
known UNIX lint utility, but has been 
greatly improved over the years by Gim¬ 
pel Software. Version 7.0 can produce 
well over 500 different diagnostics relat¬ 
ing to C and C++ syntax, usage, and pro¬ 
gramming style, and includes fairly so¬ 
phisticated techniques such as strong 
typing (yes, really strong, not the C/C++ 
idea of strong) and interstatement value 
tracking. 

To operate PC-lint, you invoke it on 
your source filets) as if it were a compil¬ 
er, PC-Iint parses the source code, pro¬ 
cesses include files, and so on, and com¬ 
plains (to stdoui) about what it considers 
to be illegal, dangerous, or just bad style. 
Generally, it finds a lot to complain about 
Its inspiration is drawn from the C and 
C++ (draft) standards, but also from expert 
advice from the books of Cargill, Coplien, 
Meyers, Murray, Plum, and Saks. As a re¬ 
sult, PC-lint acts very much as a C and 
C++ programming-in-the-small style ora¬ 
cle. There is overlap with the dynamic 
testers, though: By virtue of its initializa¬ 
tion and value tracking, and also because 
it recognizes more general problems (for 
example, absence of copy constructors or 
assignment operators in classes w ith point- 


Instrumentation Techniques 


I nstrumentation, in the context of this 
article, i.s the process of adding extra 
code to monitor a program's behavior. 
Sometimes object code in die executable 
image itself is changed; at other times, 
program flow* is diverted by patching 
entry points to external functions. 

Source-code instrumentation adds ex¬ 
tra instructions at die source-code lev¬ 
el NuMega’s BoundsChecker (widi tech¬ 
nology licensed from ParaSoft) uses this 
approach and calls it CTI ("compile time 
instrumentation , rt a slight misnomer in 
my view ). 

Compile-time instrumentation modi¬ 
fies the actual translation process and 
adds extra object code that never had 
a source code representation. This Ls 
what Borland's C++ compiler does for 
the benefit of CodeGuard. 

Link-time instrumentation uses the 
properties of the (static) link process to 


intercept calls to selected library func¬ 
tions and replace them with calls to 
equivalent, but instrumented versions of 
them. CodeGuard uses this technique. 

Object-code instrumentation takes a 
ready-to-nm executable module and in¬ 
serts additional code into it, based on 
an object-axle-level analysis of die pro¬ 
gram flow. Pure Software's Purify is die 
prime example of Lhis instrumentation 
technique, 

Run-time instrumentation, finally, de¬ 
fers instrumentation to the time when 
the executable program image is load¬ 
ed Into memory, and only then mod¬ 
ifies entry points or uses notifications 
(including processor exceptions) to get 
control at critical points. Bounds- 
Checker uses this mode of instrumen¬ 
tation. 

—R.v.dW, 
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er data members, or absence of delete op- 
erations in destructors of the same), it will 
frequently spot potential memory leaks or 
array out-of-bound accesses without ac¬ 
tually executing the program, 

PC-lint is configurable to the extreme. 
You can specify options on the command 
line, in response files, or even embed 
them as comments in your source code. 
The options range from enabling and dis¬ 
abling of certain diagnostics (in general, 
per module or per identifier) through 
specification of its operating environment 
(to albw PC-lint to mimic, say, a Microsoft 
C++ compiler, complete with the right 
definition of _MSC_VER, integer and 
pointer sizes, and include directories) to 
tailoring its output format. The latter is 
particularly useful because it allows you 
to add PC-lint as a tool to your favorite 
IDE or editor, and then use its diagnostic 
output processing to jump to the right 
source-code location in response to PC- 
lint's messages. To get you started, PC- 
llnt comes with configuration files for a 
few dozen C and C++ compilers. 

Evaluating the Tools 

The tests 1 ran included several buggy pro¬ 
grams provided by the respective vendors 
(obviously designed to bring out the best 
in ihcir tools, and the worst in their com¬ 
petitors' tools), some in-depth test pro¬ 
grams of my own, and a number of real 
programs that I worked on during the test 
period. Table 1 presents a summary of the 
results. 

Tools are only effective if you actually 
use them. So, no matter how sophisticat¬ 
ed their tests are, they must be easy to 
operate or they become shelfware. In fact, 
they should become part of the develop¬ 
ment cycle, since we all know that “test¬ 
ing quality into a product" as a final step 
in the development process is a sure way 
to doom your program to fail. 

1 could come up with carefully 
wrought analyses of which user inter¬ 
face is the best, which options make 
most sense, and so forth, and declare a 
winner on these grounds. I will not do 
so. Instead, I just kept a tally of how of¬ 
ten 1 actually used each took and to 
which tools t turned if I had a problem. 
This is not quite as scientific, but it is 
probably more honest and more indica¬ 
tive of w hich tools stood the test of prac¬ 
tice, You’ll have to bear with my per¬ 
sonal preferences (or aberrations) as far 
as my development environment goes: 
Throughout the test period, I mostly used 
Borland C++ 5.0 and Microsoft Visual 
C++ 4.1, and occasionally used Syman¬ 
tec C++ 7.21 and Watcom C++ 10.6. Pro¬ 
grams under test were Win32 console, 
GWl, and MFC GUI applications, rang¬ 
ing from small (a few hundred lines) to 



Call us today at telephone 519/836/1291 or 
facsimile 519/836/4878 to find oat more about 
the Iniellicon-NT960 and other Connect Tech 
communication products 


Intellicon-NT 960 
a RISC based multi-port 
1/ O subsystem for 
serial communications 

Performance of 512 serial ports with 4 

★ An on-baand Intel i960 host adapters in a system 
32 bit RISC processor ■* The ACM / 16 mtjduLc 
off loads the serial I / Q has both RJ45 and 

task from the main CPU DB25 connectors 
■* Offers up to 2M8 of * Offers optional on-board 
on-board dynamic RAM realtime clock and optional 
for data storage on-board battery backup 

* Offers up to 256KB of for the dual-ported RAM 

on-board dual-ported * Supports &0286. 80386 

RA M and 512KB Flash and 80486 AT bus 

E EPROM for data architecture 

storage and custom Software Flexibility 

application programs * Development tools 

★ RISC-like quad UARTS available for custom 

w iLh 24 bytes of FIFO development 

per channel provide high * Software support for 
speed data communi- UNIX, XENIX, QNX. 

cations up to 115K baud dqs 
on each pen Reliability 

Hardware Mobility slnce !9g5 Conned Tech’s 

* The Intel I icon-NT960 products have become 

subsystem ind udes a ^ nown £j r the j r UflSU rpa ^ 

NT960 host adapter, quality and reliability. This 
the ACM .■ J6 external tradition of providing flexible 
communications cost effective solutions is based 

module, software drivers m C nnn«i Tech s expertise in 
and manuals the design ^ 

* Pmvidcs 16 iu 128 asyn- ^ communication hard- 

chrouous serial ports war£ and ^^ At 

from one PC slot Conncct Tech we meet 

★ Accommodates a total your objectives - by design. 


<5® 


Connect Tech Inc. 727 Specdvate Ave. W. 

Meeting your objectives ..by design 1 Guelph, ON NIK !E6 


Tel: 519-836-129! 
Fax:519-8364878 
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Open Inventor 

3D Developer’s Toolkit 



Software Updates 
Technical Support 
by Phone, Fax and 
Email 


Open Inventor 2.1,1 
is now available for: 

* Windows NT™/95 

*;* /UX ' 

* Digital UNIX* 

* HP-UX 

* Solaris- 


FREE for 12 MONTHS 
After Purchase 


The Professional 30 Graphics Programming Tool 
for OpenGL Development on Windows and UNIX 

Open inventor™ redefines 3D graphics programming, making 
it easier to quickly prototype and develop complex, interactive 
3D applications based on OpenGL®. Whether you’re a novice 
or an expert 3D programmer, you'll find Open Inventors 
extensible, object-oriented architecture to be an elegant, 
powerful tool for developing standards-based visualization, 
animation and VRML applications on Windows® and UNIX®. 

WINDOWS DEVELOPERS: Portable Graphics' implementation 
of Open Inventor contains 28 new MFC extension classes, 
including OLE support for a complete Windows look and fee!! 

OpenGL is a registered trademark, and Open Inventor is a trademark o( Silicon Graphics Irtc. All alter trademarks belong to their raspecUlvfl companies. 

CIRCLE NO. 289 ON READER SERVICE CARD 


FREE Evaluation! Call Today. 


Nmil! 0BAPHI IS 
ti eih! s iimmsi [inpait 

3006 Longhorn, Suite 105 
Austin, TX 78758 

612719.8000* Fax: 512.832.0752 
info@portabie.com 
http://www.portable.com 
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Bounds- 

Code- 



Feature 

Checker 

Guard 32 

Purify NT 

PC-tint 

Instrumentation technique (*.) 

RTI SCI 

CTI 

OCI 


Static analysts 

0 



++ 

Read-pointer validation 

++ 

0 

+ 

0 

Write-pointer validation 

0 ++ 

+ 

++ 

0 

Other pointer validation 

0 + 

+ 

++ 

0 

Heap-based overwrites 

0 ++ 

+ 

++ 


Stack-based overwrites 

++ 

+ 


0 

Global overwrites 

++ 

+ 



C++ checks 

++ 

++ 

+ 

+ (static) 

C runtime library validation 

++ ++ 

++ 


0 

Windows API validation 

++ ++ 

+ 

0 


OLE validation 

++ ++ 


0 


Other API validation 

+ + 




Memory-leak checks 

+ ++ 

+ 


++ 

Handle in use checks 

++ ++ 

++ 

+ 


Other resource-leak checks 

+ + 

+ 



Instrumentation speed 

++ 0 

++ 

4- 

+ 

Runtime speed 

+ 0 

+ 

+/+ 

+ 

Other features 

Event logging 

Call profiling 



Integration with IDE 

++ (MSVC) 

++ (BC++) 

0 (MSVC) 

0/+ 

Borland C++ support 

>4,5 

>4.5 (**} 


Yes 

Microsoft C++ support 

>2.1 


>2.2 

Yes 

Symantec C++ support 

S7.0 



Yes 

Walcom C++ support 

>10,5 



Yes 

Windows 05 support 

WinSS version 

Yes 


Yes 

Windows NT support 

NT version 

Yes 

Yes 

Yes 

Other platforms/compilers 

Delphi 2,0 

Win 15 version 

Win 16 


Yes 


Table 1: Summary of features and test results. An empty ceil indicates that a 
feature is not present; otherwise grades are 0 (some), + (good) f and ++ 
(excellent). (*)$CI = source code. CTJ = compile time. 111 ~ link time , OCT *= 
object code ; RT7 = run time: (**) GodeGtmrd 32 only for Borland C++ 5.0 and 
later. 


Static and Dynamic Testing 


S tatic tests are pertbrnied without actu¬ 
ally executing die program being test¬ 
ed; dynamic tests require execution. 
Program compilation is a static test; more 
advanced farms use proven techniques to 
verify the correctness of a program. Dy¬ 
namic testing is performed in a crude form 
by protectechmcxle operating systems such 
as UNIX, OS/2, and Windows NT, which 
temiinate an application if it steps outside 
its allotted address space or instruction 
repertoire. More advanced forms use var¬ 
ious ways of instru mentation to keep a 
closer watch on die program's behavior. 

The pros of static checking are that: 
full coverage is attainable in theory (but 
not yet realized in practice); it detects 
both faults and other problems, such as 
portability, style, and the like; if is inde¬ 
pendent of the quality of test cases; and 
error reports are immediately linked to 
the actual fault. 

The cons of static checking are dial: It 
requires access to source code; in prac¬ 
tice, limits to value tracking restrict cover¬ 
age; and detection of dynamic problems 
(for example, interactions, synchroniza¬ 
tion) is limited or absent. 

The pros of dynamic checking are that 1 
It detects problems that occur only at run 
time (for instance, those caused by spe¬ 


cific interaction patterns); value tracking 
and API checking in principle are un¬ 
limited; and access to source code is not 
(always) required, 

The cons of dynamic checking are that: 
coverage is strongly determined, by the 
quality of actual test cases; detected fail¬ 
ures may be difficult to relate to actual 
faults; instrumentation changes tile pro¬ 
gram image and may introduce problems 
in and of itself; and run-time performance 
may lx? reduced and thereby cause prob¬ 
lems (in real-time systems, for instance). 

Regardless of the testing approach, a 
number of problems will not be caught. 
Errors of omission are notoriously hard 
to detect, as are errors of logic ( branch¬ 
ing the wrong way), misinterpretation 
of data values, and erroneous state tran¬ 
sitions. Also, verification of a program’s 
function against the requirements, user 
interface design, and performance test¬ 
ing are well outside die realm of these 
tools. Therefore, you'd be well-advised 
not to rely solely on automated testing 
tools. No matter how useful they are, a 
clean bill of health from such a tool 
should be regarded as a necessary, but 
by no means sufficient, condition to 
guarantee a correct program, 

—R.v.d.W. 


large (up to 60,000 lines). All programs 
were written in C++. 

The result; BoundsChecker (with RTI f 
not CTI) and Purify were die tools I used 
most often, with about equal frequency. 
The reason is quite simple: Neither re¬ 
quires changes to die build process (Pu¬ 
rify s OC1 is performed automatically 
when a program is loaded). Their usage 
frequencies are about the same because 
I use one as a second opinion to the 
other. 1 feel more comfortable with 
BoundsChecker 1 s memory-leak detection 
and API validation, but Purify inspires 
more confidence in its in-depth pointer 
checks. On the other hand, Purify can 
only be used in conjunction with Mi¬ 
crosoft-generated code, which made it 
unsuitable for the other compilers (which 
BoundsChecker could handle). The same 
goes for the target platform, but since I 
primarily use Windows NT, this was less 
of a problem, 

BoundsChecker widi CTI came in low¬ 
er in the usage count for two reasons: One 
is dial the instrumentation process requires 
a separate build, and the other is diat the 
resulting executable often ran loo slow for 
my admittedly limited patience. As a re¬ 
sell, I used BoundsChecker Pro with CTI 
primarily if 1 needed a very thorough test; 
it has no equal in this respect. (By the 
way, this is also what NuMega recom¬ 
mends.) CodeGuard is also a special case. 
First of all it depends on die Borland C++ 
compiler, and then it requires a separate 
build ( possibly also of ihe libraries used 
by the program at hand). In the end, 1 
mostly used it for one specific 16-bit OWL 
application; unfortunately, it sometimes 
crashed along with the program. 

What about PC-lint? Tills is one tool that 
requires iron discipline to use. Despite my 
best intentions, I must confess that I used 
it far less than I planned to. Apart from my 
obvious lack of discipline, 1 attribute this 
to die fact that I tired of tweaking PC-lint's 
options over raid over again. FC-lint would 
benefit greatly lT G impel Software (or some 
kind sou] in the programming community) 
would make an interactive option tweak¬ 
er available. More than anything else, con¬ 
figuring PC-lint to report the important 
things without flooding you with minor 
quibbles is a chore dial hampers day-to- 
day use of the tool. Especially if you rou¬ 
tinely use different C++ compilers with dif¬ 
ferent libraries and frameworks (as I do), 
you get I logged down in configuration file 
Upon configuration file, This is a pixy, be¬ 
cause PC-lint truly deserves to be a fully 
integrated pail of your development envi¬ 
ronment. 

Conclusions 

BoundsChecker will be the testing tool of 
choice for many situations. It Is broad in 
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scope and T in combination with CTI, 
catches almost any error that relates to 
memory usage. However, you should be 
aware of die fact that to use CTI you need 
to add a separate build variant to your de- 
vebpment pirxess, that a CTT-mstmmented 
executable can be significantly slower 
than a regular one, and finally, dial only 
Microsoft Visual C++ compilers are sup¬ 
ported with CTI. 

CodeGuard is a good tool for Borland 
C/C++ users. As part of the Development 
Suite, it is inexpensive and covers a large 
number of common errors. On die other 
hand, it requires a separate build variant, 
and its error detection is sometimes flaky 
and may even crash the program. 

Purify combines excellent error detec¬ 
tion capabilities with an easy-to-use in¬ 
strumentation step, requiring no changes 
to your development process. Moreover, 
run-time performance with instrumenta¬ 
tion Is reasonable to good, so there is Hi¬ 
de reason not to use it. Regrettably, it lacks 
extensive API validation and is currently 
only available for Microsoft Visual C++ pro¬ 
grams running under Windows NT. 

PC-lint is In a different category alto¬ 
gether. It can be extremely useful for both 
C and C++ developers, but effective use 
requires quite some configuration work. 
Nevertheless, I would strongly recommend 
it for use with C and C++ programming, 
since it will uncover much dubious or out¬ 
right incorrect code that many other tcxils 
will miss. 


For More Information 

Nu Mega Technologies 
9 Townsend West 
Nashua, NH 03063 
6G3-8S9-2386 
http V/www. nu mega, tom/ 

Borland International 
100 Borland Wav 
Scotts Valley, CA 93066 
408-43M000 

1 it tp: //■www.borlan d. com/ 
Pure Atria 

1309 South Mary Avenue 
Sunnyvale, CA 94087 
408-720-1600 

litTp://www,piireatria.coni/ 

Ginipel Software 

3207 Hogarth Lane 

Collegeville. PA 19426 

610-584-4261 

http: //■w ww. gi mpe l.corn 


DDJ 



C++ Matrix Library 


MAT<LIB> is a Matlab'® Compatible C++ Matrix 
Class Library, designed for development of advanced 
scientific high-level C++ code. Evaluation version 
available from our home page: 


http://www.mathtools.com 


The Library 

The library includes Complex math, 
Binary and unary operators, Powerful 
indexing capability, Trignometric. 
Signal processing. File I/O, Linear 
algebra, String operations and 
Graphics. Over 300 mathematical 
functions are included in MAT<LIB>. 
Complex matrices are fully 
supported. Matrix can be complex or 
real; real matrix uses half the 
memory. 

Performance 

The library is built locally by your 
optimizing C++ compiler, for best 
performance. Local BLAS 1 and 3 
libraries will be utilized. 

Linear algebra 

The Linear Algebra functions are 
based on Lite well known LINPACK 
and EISPACK. Cholesky, 

Hessenberg, LU, QR, QZ, Schur and 
SVD matrix decompositions are 
supplied. 

Graphics 

2D and 3D Graphics are supported in 
standalone applications using the 
freely available graphics package, 
Gnuplot. 


Memory 

MAT<LIB> supports matrices of 
doubles, floats, ints and chars mixed 
in the program. Images can be stored 
in matrices of chars, using 1/8 
memory storage. On many 
applications, where 8 digits of 
precision are sufficient, float- 
precision matrices can save half the 
memory usage. Memory allocation 
and de-allocation is managed 
automatically. 

Portability 

MAT<LIB> supports Windows 3.11, 
Windows 95, Windows NT, OS/2, 
Linux, SunOS, Solaris, Irix, A1X, 
HPUX, OS FI, Ultrix and more. 

Evaluation version 

Fully functional, time limited (30 
days) evaluation version of 
MAT<LIB> can be downloaded 
freely from our home page. 

Pricing 

The price of MAT<LIB> for a single 
user license is $399 for commercial, 
$199 for academic institutes. 

Prices are valid until July 1, 1997. 


MathToois 


Web: hup://www, mathtools.com 
Email: intb@mathtools.com 
Fax: ! -888 MATHTOOLS 


MatJab is a registered trademark of The Math Works. Inc. Trademarks of companies mentioned appear for identification 
purposes only and are the piupeny of their respective companies. 
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UNIT/REGRESSION TESTING 


Listing One 


N Makefile with automated regression testing 
H Copytight 1996 Adrian C. McCarthy 

H Written for Borland MAKE. This copy has been simplified to demonstrate 
H the integration of unit testing and automated regression testing. It 
II is not a complete platform for building a program. 

Itft IHII ft ft t ttttft ## ft f ###!#### I #ft ft H## I ### ft ft ft ft #### »tt# I #### * ###4t#l ####### ft ft 1 


II Targets 

II accept copie a teat results to reference directory 

H all builds all executables {default) 

ll clean deletes all non-source files (executables, objs. etc,} 
ft regress builds all unit test and creates a regression report 

ft release PKEIPs the deliverable files and puts them in BINDIR 

It Option Macros 

it DEBUG if defined, compile and link with debugging information 
it MODEL memory modal to compile for 

ft [1. m. e i or s for large, medium, compact, or small) 

ft PLATFORM 2, 3. 4. or 5 for 286, 386, 406, or Pentium 


ft Directory Macros 

ft BlMEIlR directory to place executablea 

ft TINDIR directory containing module test dats 

ft GBJDIR directory to place object files and libraries 

* OUTDIR directory to place test results 

ft REFDIR directory where reference test results are kept 

t SRCDIR directory containing sources 

### ft ft# ft ft ##ftft####H ##f###ft ft ####?# ft If ### ft ###§####### ft ft ###### t###ft##ft Ift### ft 


t Target platform 
lifdef PLATFORM 
PlATF0RM=-$ (PLATFORM) 
!endif 


.cpp.objh 

$(CC) $(COPTS) -n$(OEJDIR} $< 

H This rule rana a Unit teat. 

,in,out: 

$(BINDIR)\5t.exe < $C > $@ 

ftftft###ft Pseudo-targets ftftftftti## 
all : 5(EKES) S(REGRPT) 

ft The accept target copies the current teat results to the reference 
ft directory. To avoid costly accidents, we generally keep the 
ft reference cO-pieS read-only. Had we make backups of the current ones 
ft right before replacing them, 
accept ; 3(TRm)UT5) 

-flttrib -r $(REFDIR)\*,bak 
-del $(REFDIR)\*,bak 
rename §(REFDIR)\*.out ft.bak 
copy $(OUTDIR)\*.out 3(REFDIR) 
attrib +r 3(REFDIR)\*.out 
clean 2 

-del $(GBJDIR)\ft,abj 
-del $(BINDIR)\*.exe 
-del $(BINDIR),rap 
-del $(OUTDIR) \>t.out 
-dal $ (REGRET) 
regress : $(REGRET) 
release : $(EXES) 

3(ZIP) 3(B1NDIR)\ART96,Z1F 3(EKES) 

####### Regression testing ftftttftftftft 

ti The macro modifiers don't work on the S** or 3? targets, so 
II you have to add a $(DIFF) line for each new unit test. 

$(REGRPT) : $(TESTOUTS) 

echo Regression Test Report > $(RE£RPT) 
echo ================ » $(RKCRPr) 

$(DIFE) S{RlFDlR)\tvactor4,QUt 3(GUTPlRUt vector*, out » S(REGRPT) 

$[DIFF) S(RRFDIR)\tPatrix4.out $(OUTDIR)VtmfttrixA,out >> S(REGRPT) 

3[DIFF) 3{REFDIR)\tprepro,out $(OUTDIR)\tprepro,cut » ${REGRET) 


II Debug control 
lifdef DEBUG 
CDHGOFT = -v -DDEBUG ~v 

ft -v include debug info 

H -DDEBUG Hdcfines DEBUG 

It -w display aU warnings 

LDBGOPT = /v 

Imeasage Debugging enabled -- no optimization 
! elae 

CDBGOPT = -Ox $(PLATFORM) 

I massage Optimization enabled — no debugging 
lendif 

!ifndef BINDIR 
BINDIR = . Ah in 
landif 

Iifndef TINDIR 
TINDIR * , ,\test\in 
1 endif 

1ifndef OBJDIR 
OBJDIR = .,\obj 
I endif 

Iifndef OUTDIR 
OUTDIR = .,\test\out 
lendif 

Iifndef REFDIR 
REFDIR = ..\test\ref 
lendif 

IIfndef SRCDIR 
SRCDIR = . Asource 
lendif 

* Memory model 
!ifndef MODEL 

MODEL = s 

I message Using small memory model by default, 
lendif 

* b IftA H Toole and Options k H a 
CMDLGFT - -m3(MODEL) 1$(INCLUDE) 

STARTUP = C03{MODEL).obj 

RUNTIME ^ emu,lib msth$(MODEL).lib n3 (MODEL).lib 
ft Borland C/C++ comp11Er 
CC = bee -e 

COPTS = S(GDBGUPT) SfCMDLOPT) 
ft Borland TLINK 
LINK = clink 

LOFTS = /c /m /n /Tda /L$[LIE):$(OBJDIR) 3(LDBGGFT) 

It File Compare ■ Use your favorite DIFF program here I 
DIFF ^ fc 

Hftiftttft* Paths ftHttftfttill 
.path.exe=3(BINDIR) 

. path. rap= 3 (OBJDlR) 

.path. lib=$ (OBJDIR) 

. path, qbj=3 (OBiIDIF) 

.patb.c =3(SRCDIR) 

- pat h.cpp=3(GRCPIR) 

.path-in =3(TINDIR) 

,path.out=3(OUTDIR) 

,path,rpt=3(OUTDIR) 

ftHHftfttlH Files ft#ft###f 

* Nate, for each new unit teat, you need to add a &{D1FF) line to the 
ft regreaa.rpt target. You alao need to add an explicit link rule for 
t the corresponding unit test- This is because the $*** and 3? macros 
ft don’t work in implicit rules nor do they work with macro modifiers, 
TE5TEXES = tvector4.exe tmatrix4.exe tprepro,exe 

TESTOUTS = tvectorA.nut tmatrixA.out tprepro,out 
REGRET = $(OUTDIR)\regress,rpt 
.precioua $(TESTOUTS) $[REG RPT) 

ftRules ftftftkttftft 
.c.obj: 

3{GC) $(COPTS) -n$(OBJDLR) $< 


ftftSHftftft Dependencies fttMftftH 
vectorA.ohj : vector4.cpp voctor4.h 
tvector4.obj : tvector4.cpp Jthase.h vector4.h 
tvectar4.exe : tvectar4.obj vectorA.obj 
$ [LINK) $ (LOFTS) 

3{STARTUP)+ 

$** 

$>* . exe 
3*.map 
$(RUNTIME) 

tvaQtor4.out : tvactor4.exe tvector4,in 
niatrix44,obj : »atriK44.cpp mfl,trix44,h 
tmatrix4,obj 2 tmatrix4.cpp xbaae.h matrix44.h 
tmatrix4.exe ; tmatrixA.nbj matrix44.nbj VectOr4.abj 
3(LINK) 3(LDPTS) 

$(STARTUP)+ 

$M 

Sft-ex* 

3*=.msp 
3(RUNTIME) 

tmatrixA,out 2 tinflttlx4.exe tmatrii{4.in 
pteptO.obj : preprO,Cpp prepro.h 
tprepta.obj 2 tprepto.cpp ptEpro.h 
tprepra.Exe : tprepro.ubj prspro.obj 

S(LTNK) SCLOFTS) to! 

3(STARTUP)ft 

$*■ 

3 ft.exe 

$ft.map 

^(RUNTIME) 

tprepro.out : tprepro.exe tprepro.in 


Listing Two 

U Unit test for Vector4,cpp. Reeds a file of n vectors, exercises the Vector4 
// funeciona on thoae vectors, and outputs the results. The input file should 
// start with an integer (the number of vectors) followed by the vectors. 

II include < in at ream. h > 

Hinclude "vectorA.h' 1 

#define TF(h) f* 7 "truu " : "falee") 

main() 

[ 

int count. i, j: 

eitL >> count; // ttunbat of vectors to read from cin 
Vectot4 *pv - new VeCtorA(count !2 
Vector4 tempL 


caut « "VEGTOR4 RegresBion Test rt endl 

« " - = =="" « end I fti endl: 


cout << "Reading " <C count << " vectors." << endl 5 


// The VectorA module supports iostream input and output which 
// oust be tested, but is also very convenient for this unit test 
// in general. 

CPUt <.C endl 

« "1/0 Test" « endl 
<< "=====" << endl; 
for (i = 0; i i count; 1++) t 
cin >> pVti); 

cout << "I/O " « i W " " « pVtil « endl; 

1 

cout endl 

<< "Unary Functions" « endl 

s< > i -— — 11 << endl; 


(continued on page 84) 


82 


Dr. Dobb’s Journal, February 1997 














SPONSORED BY: 


Uleb Reuleui 


WE WOULD HAVE CREATED 

A REGULAR EVENT. 


CO-SPONSORED BY: 

NElQbjects 

Microsoft 

Centu ra 




WEB DESIGN & DEVELOPMENT '97 

FEBRUARY 22-26,1997, M05C0NE,SAN FRANCISCO 


WEB DESIGN 


You know it and we know it — building useful web sites requires some pretty remarkable skills. To do it, you need 
to balance technical brilliance, design genius, and marketing savvy. To aid your cause, we've created the industry's 
deepest platform- and product-independent conference, structured around the five stages of web design and 
development We've enlisted web giants in VRML, Intranets, Java, interface design, anima¬ 
tion, databases, cybercash and more as keynotes and instructors. We've amassed a massive 
tools exhibition. And we've added some elements that make Web '97, like the web itself, 
downright exhilarating. So if you're committed to doing something spectacular with your 
web site, you'll certainly want to 
explore ours to learn more and register. 


& DEVELOPMENT 


BIG. VERY BIG. 
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Communications? 


Compression? 


Lots of 
New Stuff 


From Greenleaf 

Visit us today.,. \ 

http://tvwAv.0leaf.com/-gleaf —— 


i 

NEW- —Vi ewComm for Windows 

Asynch communications debugger &. protocol analyzer 
for Windows 93 and NT. See data and control signals on 
K.S-232 links in real-time or review captured data. Flexible 
trigger system provide s start-stop control of display or 
capture. Graphical display of modem & control signals. 
Data display in hex. octal, decimal, binary. ASCII & ESC DIG 
data. Character or hex displays. Searches. Many extras. 
ViewComm/DOS also available. Download TestDHve today: 
h ttp://www.g leaf .com/-g I eaf 

I 

4 

1 

% 

i 

NEW— ArchiveLib 2.1 

Greenleaf proprietary and FKZIF 2.Ox compatible 
compression engines. Flexible archiving including 
compatibility with PKZIF. Archive to memory or 
file, PKWAfsE compatible encryption, Visual Sasic, 
Pascal, Delphi, and C/C++ APIs. Supports Windows 
93. NT, Windows 3.1x, OS/2 Warp, and 16- and 
52-bit DOS. 


Green leaf Comm++ 3.0 

Asyno communications the C++ way. Classes for 
file transfer terminal emulation, screen drivers, 
modem and port control, flow control. Supports 
16550, smart and non-smart multi-port boards. 
Supports Windows 95, NT, Windows 3.1x, OS/2 Warp, 
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(continued from page 82) 

for {i = 0; i ( count; i++) [ 

COUI << pVEi] ff 11 Homo g,eHeau.fl: 11 

« TF CpV [i] . laHomo geneoua Q } « endl; 
c out < < "Homogenize 41 f f pV [i I f < “ = |M ; 
pV[i) . HaHDgenize (} ; 
cout « pVli] ff endl: 


cout « pV[i] « ,T Unit: " « TF(pV[i] .IrfnitO) « endl; 
temp = pV LU ; 

if ftemp.Magnitude0 1= 0,0) £ 
temp-Unitize{); 

cout ff "Unitize ,f « pV[il f< " = " « temp 

ff " f" <f temp,Hagn.itude() « 11 )" ff endl; 

1 

else ( 

cout ff ‘'Can't make zerg vectgr unit length, 1 * « endl; 

] 

tout « "It" « pV[i] « *1! = N < <■ pVtil.Magnitude() 

« endl: 

cout « "if ff pV[i] f< "IfZ “ * « pV[i] .KagSquareO 
« endl; 
temp = -pVtiJ; 

cout <f " ff pV[i] << ,r 3 11 ff temp << endl; 
teup = 0*pY[i]; 

CQUt « “0*" ff pVii] ff " “ " << temp ff endl; 
temp = 1,0*pV[i]; 

cout << "I*" ({ pVfi] C< " = " ft temp C< endl: 
temp = pVfi]*2; 

cant Cf pV(i] f< *‘•2" ** = « temp Cf endl: 

cout <f ,f —” << endl: 

] 

cent << endl 

ff ,r Binary functions" f< endl 
ff ''^======3 =itzeh endl; 

for [i - 0; i < count; 1++) { 

fee tj = 0; j f count; J++) t 

ccut « pV[i] « " * " « pVtJ] «< *i " 

« TFtpVll] — pV[j]) ff endl; 
coiit <f pVfil << " 1- " ff pV[jJ « W J " 
ff Tf(bY[i] ! = pVlj]) « endl: 
tamp = pVLij + pV£j] ; 
cout ff pVLij f< M * 
temp = pVLij - pV til; 
cout << pVLil << " - 
lemp = pV[i] ; 
tamp += pV [j I; 
cout << pv[il « 

« endl; 
temp - pV[ij; 
temp -= pVfj]; 

cout ff pV[i] ff ,r " ff pVH] « 
cout ff pv[i] f< ir dot " ff pVijj f 
<f Dot(pV[i], pV[jJ > <f endl; 
temp - Cross{pV[i] r pV[J]); 

cout <f pVEi] ff 1f cross " ft pVfjJ ff Hl - " ff temp 
f f etidl; 

cout ff **-*“ ff endl; 

1 

1 

delete pV; 
return 0: 


« pvLJJ << 1 

« pY[j] <C 1 


f< temp <f endl: 
f< temp << endl; 


+=^ " ff pV [jl ff '* * ff temp 


1 = '■ ff temp ff endl: 


Listing Three 

9 

[1 9 0] 

[0 1 B] 

[0 0 1 ] 

[1 i 1] 

0 0 0 ] 

4 A 4 [2)1 
1 2 3 { 1)1 
3 l 1 £0)1 

1,23456? 1.234567S9 1.234567B901234567090J 


DEBUG/TRACE 


Listing One 

Ninclude fstdip-h> 

H include f at-dlih, h > 

Iinclude <stdarg-h> 

/•Infinity must bo higher than the largest path value */ 
/* Matt i rnt im number of nodes In the network */ 


/*E?ecHa.nently labeled fc / 
/•Temporarily laheled */ 


I define EW 1000 
Hdefine N 10 

* dafine TRUE I 
Idefine FALSE 0 

♦ define PERM 1 
♦define TEMP 0 


/•-Function declarntions- 


-*/ 


int dijlestra(int a, int t. int wL] tN] , int final [J , int distLJ, inrt pred []); 

extern void dbg_init(void); 

extern void dbg(cliar *, int, char •. 

/» — ——-Fune c ion de f init iona -——--—---- - - */ 

Int dijkstra{int a. int t, int w[] [Mj . int final{]. int dist [] . int pred[]J 

t 

int u, v. y, recant, oewlabal, min. path: 

/ •--initifllizet ion-* / 

dbg_in.it (): 

for £v=#; vflf: v++) 

£ 

dist[vj = INF; /*Set all distnncea to infinity */ 

finalEvl - TEMP; /tSet ail nodes to "temporarily labeled 1 * */ 
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pred[v] 


= -ij 


I 

dist[a] = 0; 

filial la] =■ PERM; 
path = TRUE 3 
recent = s; 


/*Set nodes in shortest path trace to 1r non existent” • / 

/‘Distance from s to s is 0 */ 

/‘Set node s to “permanently labeled" */ 

/‘Aastime there is a path from S to t */ 

/‘Moat recent node is a */ 


/*-Run Dijkstra'fi Algorithm--*/ 

for(u=0:u<6:u**) 

{ 

for(v=0;v<6;v++) 

dbg["l_liiitr , F 2 1 "wl/d] [vd] = /d ", u, v, w[uj [v]); 

dhg("l_ird.t2". 1 ,“&u = /pW\£u): 

while(final[t]^^TEMP) /‘while destination node t is temporarily labeled */ 

[ 

for{v=0: v<H; v++) 

f 

if ((wLrecent]lvj t INF) ifc (final Lv] 3) /‘node temporarily labeled */ 

E 

newlabel = dist[recent] + vLrecent] [vj ; 

if (newlabel S distM) Anew distance, smaller than previous one +/ 
{ 

diatfv] 31 newlabel; /‘update distance */ 

predfvj - recent; /‘put predecessor in shortest path */ 

dhg{”2_dist lf ^. “recent - /d newlabel ^ /d \n" , recant, newlabel) ; 

J " 


■in = INF: Areset temporary minimum */ 

for(u=0: iKN: u++) /'Find siaalleEt labeled node */ 

t 

dbg {”3 _ u", 1, ''u=/d\n ir , u}; 

if {(finaltu]^=TEMP) && (disttul < min)) Anode temporarily labeled ■/ 
C 

y = u; /‘Save node in y */ 

min = dist [u] : /‘Reduce temporary minimum */ 


} 

J 

if (min < IMF] 
l 

final [y] = PERN; 
recent = y; 

) 

else 

E 

path = FALSE, 
final[t] = FERH; 

} 


/‘if there fa a path */ 

/*if there is no path */ 

Ainduce break of while loop */ 


return(path); 


NT FILE SYSTEM 


Listing One 


typedef struct -FILE-OBJECT { 

GSHORT Type; 

CSHORT Size; 

FDEVICE OBJECT DeviceObject; 

PVPB Vpb; 

PVOID FsContext; 

PVOID raConteitt2: 

PSECTION_QBJECT_ POINTERS Sec tionObj ec tFainter; 
PVOID privateCacbeMap; 

NTSTATOS FinalStatus; 


struct -FILI-OBJECT •RelatedFileObject; 


BOOLEAN 
BOOLEAN 
BOOLEAN 
BOOLEAN 
BOOLEAN 
BOOLEAN 
BOOLEAN 
BOOLEAN 
ULDNG 

UNICODE.STRING 

LARGE.INTEGER 

OLD NO 

ULONG 

PVOID 

KEVENT 


LockOperation: 
DeletePending; 
ReadAccess; 
WriteAccess; 
DeleteAccesGi 
SharedRend; 
SharedWrite; 
SbaredDelete; 
Flags: 

FileNane; 

Cur r ent EyteDf f' a et; 
Waiters: 

Busy: 

LastLock; 

Lock; 


KEVENT Event; 

PIO COMPLETION CONTEXT CompletionCont«t: 
] FILE.OBJECT; 


Listing Two 

typedef struct _IRP [ 

CSHOBT Type; 

DSHOKT Size; 

// Define the comon fields Used to control the IRE. 

// Define a pointer tD the Memory Descriptor List (MLL) for this I/O 
// request. This field is only used if the I/O la “direct I/O". 

PMDL HdlAddress; 

// Flags word - used to remember various flags, 

ULONG Flags; 

// The following union is us ad for one of three purposes: 

// 1. An associated IRF, Field is a pointer to a master IRF. 

// 2. The msater IRP, Field is the count of the number of IRPs which must 

// complete (assocleted IRPs) before the master can complete, 

// 3. This operation la being buffered and the field la the address of 

// the system apace buffer, 

union [ 

struct -IRF *MaeterIrp: 

LONG IrpCount; 

(continued on page 86) 
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(continued from page 85) 

FVOID SystemBuffer: 

J Asaaniatadlrp; 

// Thread list Entry - allows queueing the IRF to the thread pending I/O 
// request packet list. 

[J ST.ENTRY ThreadLiatEntry: 

// I/O status - final status of operation. 

I0_ STATUS _ BLOCK loStatus: 

// Requestor mode - mode of the original requestor of this operation. 
KPRDCE&SOR.MODE RequestorMode; 

// Pending returned - TRUE if pending was initially returned se the 
// status for this packet. 

BOOLEAN PeJidingRetumed; 

// Stack state information. 

CHAR Stack Count: 

CHAR Currenthocatian: 

// Cancel - packet has bean canceled. 

BOOLEAN _ Cancel: 

// Cancel Irql - IrqJ at which the cancel spinlock was acquired. 

ItlltQL Cancel I rq l: 

// ApcEnvironmem - Used to save the AFC environment at the time that the 
// packet was Initialized. 

GCHAR ApcEiwironment; 

// Zoned - patket was allocated From a zone. 

BOOLEAN Zoned; 

// User parameters. 

PIOJTATUS.BLOCK Lfaerloab: 

PREVENT UsetEvent; 

union [ 

tfttuet 1 

PIO-APC-ROOTINE UserApcRoutine; 

PVOID DserApcConteit; 

3 AsynchronousFaramoters; 

LARGE,INTEGER AllocationSize; 

3 Overlay: 

// GanceIRoUtine ■ Used to contain the addresa of a cancel routine supplied 
// by a device driver when the 1RP ia in a cancelable state, 

PDRIVER .CANCEL CaneelRoutinej 

// Note that the UaerHilffer parameter id outaide of the stack ea that I/O 
// compietion can copy data back into the user's address space without 
// having to know exactly which service was being invoked. The length 
// of the copy 1 b stored in the second half of the I/O status block. If 
// the UserBuffer field is NULL, then no copy is performed. 

PVOID UserBuffar: 

// Kernel structures 

// The following uection contains kernel structures which the IRP needs 
// in order La place various work information in kernel controller system 
// queues. Because the size and alignment cannot be controlled, they are 
// placed here fit the end so they just hang off and do not affect the 

// alignment of other fields in the IRF. 
union [ 

struct [ 

// DeviceQueuoEntry ■ The device queue entry field is used to queue 


// the IHF to the device driver device queue. 

KDEVICE _QDEUE_ENTRY Devie eQueueEnt ry; 

// Thread - pointer to caller's Thread Control Block. 

PETHREAD Thread: 

// Auxiliary buffer - pointer to any auxiliary buffer that is 
// required to pass information to a driver that ia not contained 
// in a normal buffer. 

PCHAR AuxiliaryBuffet; 

// List entry - queues packet to completion queue, among othere- 
LIST.ENTRY ListEntry: 

// Current stack location - contains a pointer to the current 
// 1G_ STACE_L0CATJ!ON structure in the IRF stack. This field 
// should oever be directly accessed by drivers. They should 
// use the standard functions, 
struct .10_ETACK_LOCATION *CurrentStackLocation; 

// Original file object - pointer to the original file object 
// that was used to open the file. Thia field ia owned by the 
// I/O ayetea and should not be used by any other drivere. 

PFILE. OBJECT QriginalPil eOb j ect: 

1 Overlay: 

// ARC - Thia AFC control block ia uaed far the special kernel AFC as 
// well as for the caller's AFC. if one was specified, in the original 
// argument list, if so. then the AFC is reused for the normal AFC for 
// whatever mode the csiler was in and the "special" routine that is 
if invoked before the AFC gets control simply deallocates the IRF. 

KAFC Ape; 

// CompletionKey - This is the key that ia used to distinguish 
// individual I/O operations Initiated on a single file handle. 

ULQWG CompletlonEey: 

3 Tail: 

] IRF h *PIRPj 


Listing Three 


BOOLEAN HaokUrive( IN char Drive, IN PDRIVKR.OBJECT DriverObject 3 
t 


I0_STArU5_BLOCK 
RANDLE 

OBJECT.ATTRIBUTES 

PDK7TCE..CBJECT 

PDEVICE.,OBJECT 

UNICODE.STRING 

VCHAR 

NTSTATUS 

ULOMG 

PFILE.OBJECT 
PHOOE.EXTENSION 


ioStatus; 

ntFileHandJe: 

obi ec tAttributes; 

filoSysDovica: 

hookDevice: 

fileNameUnicodeS L ring: 

filename [j - L M V\l]aBDeviCes\\A:\\" : 

ntStatuE: 

i: 

f1leObject; 
hookExtenaipn; 


if ( Drive >= 'a f ki Drive 'z' 3 Drive ■= 'a ,m , 
else Drive 'A' ; 

if ( (uEiaigned chat] Drive 26 ) 

return FALSE: 


if ( LDfiveDevicea[Drive] =- NULL 3 l 
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// point to the current logical drive 
filename[12] = 'A'+Drive; 

// have to figure out what device to hook - first open the root directory 
RtllnitUnic ode String { ifileNaiaeUnic ode String, filename }; 

InitializeObj ec tAtt ribute a f &abjectAtt cibutes, frfileKameUnieodeString, 
OBJ_CA&E_INSENSITIVE, MULL, HULL }: 
ntStatus = ^WCreateFU e[ iirtfileEWle. fi¥WCHftQKlZE|FlLB_fiEAD_ACCESS 1 
fcobjectAttributes. iloStatue, NULL, 0. 

FJLE_5HARE_READ J F rLE_SHARE_VmiTE. j 1LE_ OPEN , 

FILE. S¥HCHR0*WUS_I0JKJWAmX 1 

FILE..DFEN_FQR_BACKUF_INTENT l FILE-DTRECTORY-FILE, NULL. 0 ): 
if( 1 NT.SUCCESS( ntStatus ) } return FALSE; 

// got the file handle, so now look-up the file-object 

ntStatus = QbRefereneeGbjertByHandle! ntFileHandle, FILE ..READ-DATA, 

NULL, KetnelMode h SfileObject. NULL ): 
if( I NT,SUCCESS! ntStatue )) return FALSE; 

// now. find ant whet device is associated with the abject 
fileSyeDevice = IcGetRE;latedfleviceObject{ fileObject ) J 
if ( r fileSyeDevice ) ( 

EwC1ose( ntFileHandle 3; 
return FALSE; 

) 

// make sure we haven't already attached to this device 
// (which can happen for directory mounted drives for networks) 
for( i « 0; i ( 26; i++ ) £ 

iff LDriveDavicea[i] -- fileSysDevice ) £ 

// yep. already watching it sro add it to a group 
ObDerefereuceDbj act ( fileObject ]J 
ZwClosef ntFileHandle }; 

LDriveMapf Drive ] - LDriveMap [i]: 

LDriveDavicesl Drive j = fileSysDevice: 
return TRUE; 

3 

J 

// create a device to attach to the chain 

ntStatus * IoCreateDevice{ DriverObject, sizeof(HOQK-EKTENSION). NULL, 
fileSyaDevice^JDeviceType, 0, FALSE, ShookUevice ); 

// did we create a device successfully? 
if ( tNT-SUCCESS(ntStatus) ) return FALSE; 

// clear our init flag as per NT DDR KB article on creating 
// device objects from a dispatch routine 
hookDevice->Hagan *= ™D0_PEVtCE_INITIALISING; 

If set-up the device extensions 
hookExtension = hookDevice->reviceExtension; 
hookExtension->LogicalDrive = "A'+Drive; 
hookExtensiofi-JFileSystem - flleSysDavice; 

If now. attach ourselves to the device 

ncStatue * IcAttachDeviceByPointer( hookDevice, fileSyeDcvice ); 
if £ INT_SUCCESS(ntStatus) ) [ 

// if We couldn't attach 
ObDereferencaDbject( fileObject 
£wCloge( fitFileHandle ); 
return FALSE: 

} else [ 

// assign this drive a drive group if it doesn't have one 
Iff !LDriveKap[ Drive ] ) LDriveMap£ Drive ] = ++LDriveOroup; 

5 

// close the file and update our list 
ObDe r efe reneeObj ec t f fileOh j set ); 

ZwClose( ntFileHandle ): 

LDrivethavieea [Drive] = hodkflevice; 

} 

return TRUE: 


C + + PROGRAM ANALYZERS 


Listing One 

// 20 M24 S Avoid gratuitous use of virtual inheritance, i.e,. make 

// sure theta are at least two inheritance paths to each virtual base class. 

class Base { int x; ]; 

claaa Derived: virtual public Base [J3 

Derived d; 


Listing Two 

class B £ ); 

class D: public B £ ... J; 

void f£B *p): 

D *pd ■ new D; 
f(pd); 

void f[B *pj 

t 

delete p: 

3 


// base class; assume no virtual dtor 
// derived class 

If f is sane function taking a B* 

If pd points to a D 

If pass pd to f. binding pd to p in f 


// this calls only B's dtor, not D's! 


Listing Three 

// test program for rule 10 


class Base (): 

class Derived: public Base £3; 


int mainf) 

£ 

Base *pb = new Derived; 
delete pb: 
return 0; 
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Course on C/C++ 





j FI Stevens, a world renowned programming expert 

,_- and contributing editor for Dr Dohb'sJournal , 

' has created the CD-ROM to answer all your 
C/C++ programming questions - the AI Stevens Cram 
Course on C/C++* 


This CD-ROM includes the complete text of three books 
written by AJ Stevens, an interactive step-by-step tutorial 
with precise explanations, video clips of A1 discussing 
important topics, a compiler directly connected to the 
exercises, lots of usable source code, plus a memory feature 
that bookmarks your place for quick returns to prior sessions. 

Use this CD-ROM on your programming projects to 
answer questions, work through actual examples, compile 
your example source code, and make sure its correct 
right then and there. 


Or complete the form and return to : 

Fax: 913-841-2624; E-mail: orders@mfi.com; 
Int’f: Use mail, fax, e-mail, or call 913-841-1631 


Please send me an At Stevens Cram Course on C/C++ CD-ROM 
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Al Stevens Cram Course on C/C++ will help you become a 
more proficient programmer. 

This multimedia CD-ROM features: 

* Three Complete Programming Books 

* Interactive Tutorials 

* Built in Compiler 

* Video Clips 

* Bookmark for Quick Returns 

* Background Music Performed by AJ Stevens 

See screen shots and a more detailed explanation on our 
Website: www.ddj.com/cdrom/alstevens.htm 

Includes these Books by AJ Stevens: 

Welcome to Programming 

Straight forward explanations of 
computer files, code , and language 
makes programming simple. 


A1 Stevens Teaches C 

The perfect introduction to C with 
an organized\ structured approach, 
teaching good programming through 
good example « 


Teach Yourself...C++ 

This hook demonstrates the hows and 
whys of C++ program design in an 
accessible, informative style. 


Order Today! 800-548-1971 
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* 486/40 (486/66 recommended) * Wui95 or NT 
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PROGRAMMING PARADIGMS 


Some Observations 
on Apple and Java 



Michael Swaine 


O ver Lhe years l have tried, in print 
here and elsewhere, to follow the 
evolution of the Macintosh operat¬ 
ing system, I haven't written much 
on die subject recently, because there just 
hasn’t been much to write. This month, 
though, 1 face the formidable challenge 
of writing about the future of the MacOS 
after it has more or less been pronounced 
officially dead. 

After that exercise in exhumation, I'll 
he in just the right mood to dig up some 
more bones from computing’s history next 
month. This month, though, I'm playing 
devil's advocate by: L assuming Apple 
has a future, and 2, criticizing Java. 

Beaten: The System 

In the only slightly distant past, just this 
side of where the mists of forgetfulness 
drift as thick as my beard and as gray as 
my hair, T wrote, for a magazine that shall 
remain nameless, a column that shall be 
here named “Beating the System. 11 

The system in question was the MacOS, 
die magazine in question was one dedi¬ 
cated to the Mac user, and in those now- 
hazy days (though I’m not so sure they 
weren't just as hazy when we were going 
through them) the MacOS was a mere 
rosy-cheeked six-dot-ecks versions old. 1 
share these reminiscences with you not 
only out of the magnanimity of my spirit 
but also in furtherance of a point, which 
I expect well stumble over in one of the 
forthcoming paragraphs. 

Earlier, I had clone a HyperTalk script¬ 
ing column for die magazine in question, 
and later, toward die end of my tenure as 
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a system beater for the mag in Q, the OS 
in Q turned seven-dot-oh. Time, as is its 
wont, passed, and so did 1, from baek- 
of-book system-beating columnist to 
front-of-book eponymous columnist and 
later from FOB eponyrnisl to BOB Inter¬ 
net traveler, making in all four columns 
for the same magazine. The more things 
change, long-time readers must have 
thought, the more they remain this 
Swaine. i checked in with Time the oth¬ 
er day to see if it was done. Il wasn't, but 
it did have some interesting news. The 
MacOS was still holding at seven-dot- 
ecks, Time said, and was expecting to 
hold there for a while yet. Version eight 
was, well, in question. In fact, dead. 
Trashed. Thrown into the binhex of des¬ 
tiny, Time said, by which 1 understood it 
meant the dustbin of histoiy. Time's a lit 
tie dyslexic. Meanwhile, no system nine- 
dot-oh is revving toward betatude, no 
bright young understudy from R&D awaits 
its chance at stardom, no MacOS95 or 
MacOSNT trembles in the wings, anxious 
to leap onstage like Booth from the box 
to cry “Sic semper tyrannis, Bill GJ” 

If 1 have limned this sketch clearly, you 
should see that as of the precise moment 
in question (die moment previously iden¬ 
tified as “the other day”), Apple had no 
Macintosh operating-system future. None, 
This is, I think you’ll agree, an interesting 
position for a computer company to be in, 
I make a point of clarifying the position lie- 
cause of the remarkable electric shock that 
went through the entire Mac-observing 
community when the news came om last 
fall that Apple was going to replace the 
current aging operating system with a 
new one—here comes the good part— 
written entirely from scratch. 


Truthfully, j can’t speak for the entire 
Mac-observing community. An electric- 
shock went through one Mac observer, 
namely me, on hearing the news. 

And it shouldn’t have, As an old system 
beater from way back, T should have been 
tetter insulated. This news flash shouldn’t 
have shocked anyone. After all, w r hat op¬ 
tions did Apple have? To declare operat¬ 
ing systems obsolete? I suppose that 
thought has crossed the minds of the 
members of the OpenDoc team. If Steve 
Jobs were still CEO, that might look like 
a real option. 

However, immediately on the heels of 
this from-scratch story came die denials. 
Yes, Dtxlor Amelio had said something 
like that, but no, Apple wasn’t really go¬ 
ing to design and write its next operating 
system utterly from scratch. Doctor Ame¬ 
lio was just making some general obser¬ 
vations about how operating systems are 
developed. Genera lly. 

We Could Have a Contest 

Apple’s flurry of announcements and clar¬ 
ifications left certain details regarding this 
future MacOS unspecified, such as its fea¬ 
tures, nature, source, and release yean No 
doubt Apple will flesh out its plans some¬ 
what someday. 

Meanwhile (a technical term from the 
jargon of publishing, meaning “between 
the WTiting of this column in my tem¬ 
poral reality and the reading of it in 
yours"), it would be silly to try to cri¬ 
tique this operating-system-to-be. But it 
would be fun to offer Apple our sugges¬ 
tions, This is something that we Apple ob¬ 
servers do. We Windows watchers (mo¬ 
mentarily changing hats here) do it too, 
but we don’t expect Microsoft to listen to 
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us. We Apple observers not only expect 
Apple to listen to us t we expect Apple to 
do what we say, When the company 
doesn't follow our advice, w r e get mad. 
We are actually Apple Kibitzers. 

Anyone can be an Apple Kibitzer. It 
doesn’t cost anything and it's fun. 

Care to join in? 

Let’s tell Apple what we think it should 
do about its unannounced future operat¬ 
ing system, It could even lie a contest: De¬ 
sign a new operating system for Apple. (I 
don’t know who’d give out the prizes, 
though.) III scan, since 1 have the talking 
stick. Apple probably will have left a few 
details unspecified even in your temporal 
reality, so you should be able to join in. 
If not, in the unlikely event that Apple has 
already shipped the first developer release 
of a new OS by die time you read this, 
you can compare my suggestions to the 
reality. 

Be All That You Can Be 

As I write this, January's MacWorld Expo 
is shaping up to lie a real Be-in, BeOS, 
lire operating system, is getting more pre¬ 
show attention than Apple or any of its 
third-party partners. 

At first glance, diis may seem odd. BeOS 
is the software that runs on the BeBox, 
the computer announced in 1995 by Be 
Inc, T the company started by former Ap¬ 
ple products division president Jean-Louis 
Gassed in 1990, The BeBox and BeOS 
were created to do an end run around ex¬ 
isting operating systems and were de¬ 
signed from the ground up to support 
object-oriented rapid-delivery develop¬ 
ment in a truly modern operating system. 
Commendable goals, to be sure. 

But the BeBox has hardly taken the 
world by storm, and most articles about 
the company and its hardware have tend¬ 
ed to use the word “quixotic" to describe 
Be Inc.’s attempt to stake out its own plat¬ 
form niche in a market that gives at least 
some indications of having room for only 
one platform. But BeOS is very interest¬ 
ing to Apple watchers because it is a state- 
of-the-art operating system, and it runs 
on PowerPC hardware. In fact, it runs on 
die Macintosh. 

In fact, Apple’s hottest licensee, Mac- 
done maker Power Computing, has li¬ 
censed BeOS to offer on its hardware. 

In fact, Apple has been negotiating to 
license BeOS, and rumors have been ram¬ 
pant that: 

1. BeOS w ill be the next MacOS, or 

2. Apple will use a licensed version of 
BeOS to develop its own new (from 
scratch?) 05 the w-ay Microsoft devel¬ 
oped the original version of Windows 
from a Mac system-software license, or 

3. something else. 


Grafting BeOS onto the elements of sys¬ 
tem software that Apple would have to 
keep (if for no other reason than that 
BeOS doesn’t have them) w r ould use up 
several rolls of masking tape, but it would 
be a massive PR band-aid for Apple’s 
scarred, battered, and bleeding system- 
software Image. And what BeOS does sup¬ 
ply is pretty nifty. 

MacOS has what Apple calls "cooper¬ 
ative multitasking. 11 It has a crude, slow 
virtual-memory system that requires the 
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user to set the size of the VM partition 
and reboot on changing it. It has no 
memory protection, and no hardware ab¬ 
straction layer, so Mac users get to install 
various system enablers to customize the 
05 to their hardware. BeOS, on the oth¬ 
er hand, has true preemptive multitask¬ 
ing, a modern virtual-memory system, 
solid memory protection, and a hardware 
abstraction layer that made it relatively 
easy for Be to port the OS to Mac hard- 
ware, BeOS supports symmetric multi¬ 
processing (on two processors), has a 
snappy multithreaded user interface, and 
is fully object oriented, none of which 
can be said for the current MacOS. Nor, 
and here’s the real point, can it be said 
for any operating system Apple had ever 
even planned to ship in the next couple 
of years. BeOS is only in beta release 
now, but it is a better operating system 
than Apple has any hope of shipping In 
this century without going outside the 
company. 

So I d say that Apple could do worse 
than to embrace BeOS. 

Exactly how that would work, both 
technically and financially, is a question 
that I will gladly leave to Apple and Be. 
But if Apple does embrace BeOS, it will 
be quite a coup for Gassee and compa¬ 
ny. Among other things, it will mean that 


Be Inc. will go from having practically 
no applications that run on its hardware 
to inheriting the entire Mac application 
universe. 

Talk about a killer Be app. 

The Quick and the Dead 

That’s my recommendation, Apple, But if 
you don’t like it, there are other options. 

As long as you’re considering going 
outside the company to companies start¬ 
ed by former Apple employees, how 
about General Magic? Their new Rose¬ 
mary operating system is designed to am 
on RISC hardware. But then, if you’re go¬ 
ing to consider a PDA OS, you don’t have 
to leave home: You could just scale up 
the Newton operating system (or am I 
supposed to call it “Newton Intelli¬ 
gence?”). Version 2 of the Newton OS is 
pretty nice. Alone among broadly used 
operating systems, it eschews the file 
metaphor t & virtue that could make New¬ 
ton-based machines accessible to a broad¬ 
er audience than PCs enjoy. 

Crazy idea, right? But currently Sun and 
Microsoft are put ting significant efforts 
into producing, respectively, Java-based 
ope ra t i n g- s ystem i m p lememations and 
versions of Windows for smaller and small¬ 
er devices. As Microsoft struggles man¬ 
fully to scale down to PDAs and tele¬ 
phones and watches, maybe you steal a 
trick by starting with an 05 designed for 
a funky little device to l^gin with. 

Crazy idea, right? But the latest New¬ 
ton models are testing the boundary be¬ 
tween PDA and computer. The Newton 
2000 might be everything some people 
want in a portable computer, for under 
$1000.00, 162-MHz processor, 1.4 pounds, 
runs 24 hours on a charge, 480x240 
screen with 16 gray levels, and more bun¬ 
dled software than an Osborne 1. Okay, 
the keyboard is an option, but at least 
you can gel one. And the eMate, de¬ 
signed for school kids, about half the 
price of a 2000 if purchased in volume 
(keyboard included), could be all a 
schoolkid needs in a portable computer. 
If these machines catch on, maybe Ap¬ 
ple should scale the Newton OS up to 
the Mac line. Or just scrap the Mac line 
and sell Newtons. 

Neither seems likely. Some other sce¬ 
narios seem neither likely nor appealing. 
One option would be to graft the Mac 
GUI on top of NT’. That hardly qualifies 
as a crazy idea, but to those of us who 
see Apple's only role in the computing 
universe as being the grit in the bearings 
of the Microsoft juggernaut, the idea seems 
unthinkable. I choose not to think about 
it, anyway. 

Of course, inertia always favors con¬ 
tinuing with the current plan, or, in the 
case of Apple today, the current lack of 
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a plan. In this scenario, Apple trickles out 
minor revs to the OS for the rest of its 
independent corporate life, charging for 
them whatever the traffic will hear If the 
OS in the Mac is dead, the media level 
is quick—Quicklime, QuickDraw, and 
their quick spawn manage to evolve with 
the times, span platforms, and stay near 
or at the cutting edge of hot technolo¬ 
gies. Too bad you can't turn such system 
technologies into an operating system. 
Td hale to see Apple give us a replay of 
IBM in 1982; You get to choose your op¬ 
erating system. Fortunately, since they 
don't have one, they aren't really in a 
good position to offer choices. 

At last spring’s World Wide Developer's 
Conference, new Apple bass Gilbert Ame- 
Ho, referring to Apple’s financial and oili¬ 
er crises, predicted that we would won¬ 
der a year from now what all the fuss was 
about. Do you suppose he meant we'd 
forget all about past disasters in the face 
of present calamities? 

Java Will Rot Your Teeth 

The developer of a HyperCard-like en¬ 
vironment for UNIX (I'd better pause for 
a moment to let you get your mind 
around that fairly bizarre concept) has 
brought together what looks like every 
argument he could think of for why Java 
is bad, bad, bad. You can read his co¬ 
gent caveats on the Java hype machine 
at http://www.csn. net/MetaCard/java 
.html. Or you can read my summariza¬ 
tion, annotation, and augmentation of 
them here. Some of the following ideas 
are his, and the rest came to me in a 
dream. Here are ten reasons why Java is 
bad for you: 

1. We don’t need another C++. One is bad 
enough. 

2. It’s too stripped down For many pro¬ 
gramming purposes, die legacy of be¬ 
ing designed originally to run on smart 
toasters or something. Needed or de¬ 
sired Features may be added on later, 
but having the right features designed 
in from the start is the way to go. 

3. Multithreading is a pretty obscure fea¬ 
ture to include considering the things 
left out. 

4. Multithreading will rot your teeth, 

5. Java is slow. 

6. If 11 never be fast. Without explicit mem¬ 
ory management and the use of point¬ 
ers, Java can never match C for fast ex¬ 
ecutable code. And it’s interpreted, so 
the user has to wait for the kiteq^reta- 
tion phase to see the application or ap¬ 
plet execute, just-in-time compilation 
doesn’t help, 

7. Most of Java’s alleged virtues (porta¬ 
bility, ability to deliver functionality 
over the Internet, ability to screen 


code for security purposes) come from 
its being interpreted. Other interpret¬ 
ed languages have or could easily 
have these same virtues and are at the 
same time easier to program in than 
Java. Some interpreted languages also 
have large libraries to draw upon to 
speed development. We don’t need 
another Basic. 

8, The development environments cur¬ 
rently available leave something to be 
desired, 

9, How open a standard is it when a run¬ 
time environment license costs $125,000? 
And when Sun controls the develop¬ 
ment of the language? And licensees are 
required to turn any improvements they 
make over to Sun? 


10. In the late 1990s, what we need are 
more and higher high-level languages 
that can speed development of more 
pow erful, media-rich applications and 
that can call upon compiled routines 
written in an efficient low-level language 
whan they need to. We don’t need an¬ 
other C 

That’s the list. Presented for your pe¬ 
rusal in the spirit of devil’s advocacy, and 
not necessarily reflecting the views of the 
management. Personally, I like Java. Bui 
1 do believe it might be just a tiny bit over- 
hyped. 


DDJ 




NetZlP Remote Products: 

> Windows Client Tool Kit 

> Java Client Tool Kit 

> NetZIP Server 


Builders Products 
ftttp://www. netzip. com/ 

Sates: 800-432-0025 

Fax: 770-395-T616 

rmemationat: 770-395-6465 


400 Perimeter Center Terrace Worth, Suite 445. Atlanta, GA 30346, USA 

Windows is a [radamarit of Microsoft Corporation Remote 21P and C4et2lP are irtiftema+s oF Software Buddere Inlernaliornai, Inc, 


Open ZIP Files Across a Network with 
NetZlP ™ Remote... 


Gi ve your ZIP program extra 
capabilities by adding an on-line 
feature using the NetZlP Remote 
tool kit. Clients can now open a ZIP 
file without having to download the 
whole file. Now servers can eliminate 
unnecessary download traffic and 
increase bandwidth, and clients save 
time by downloading the right file 
die first time. 


Attention Developers of 

y Windows'" Networks 
^ Company Intranets 

> FTP Client Software 

> Compression Software 

Whether you use C, C++, or Java to 
write your network applications, you 
can use the NetZlP tool kit to give 
any existing Windows ZIP engine a 
remote Windows interface. 
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With all clue respect to RISC/UNIX-based systems, we think you'll iinci the Compaq Professional 
Workstation offers something that’s been sorely missing in proprietary workstations. Namely, freedom. 

To begin with, you’ll have plenty of power to run your specialized applications. This is made 
possible through a range of cutting-edge performance features. Including Compaq’s advanced system 
architecture which is optimized for Windows* NT and can run up to two Pentium* Pro processors. And 
because our workstation is based on open systems standards, you’ll find it will integrate easily into your 

d 1 s f r S b u l e d 

existing network. So instead of having to work within the constraints of' a proprietary 
system j you'll have the flexibility to accommodate your needs, whatever they are. Of 
course, with Distributed Access, you’ll also be assured of a transparent connection 

access 

to all the information you need throughout your enterprise. Even in RISC/UNIX environments. 

Another benefit is the result of our partnerships with leading independent software vendors 
like Microsoft, SDRC, Autodesk and PTC. Because these solutions have been thoroughly tested, you’ll get 
optimum performance and compatibility. 


Your Reliance On Conventional Workstations 
I s About To Change Forever. 


Finally, our workstation provides a lower cost of ownership—not only through price: performance 
but also through Compaq’s industry-leading management features 
and comprehensive service and support programs. Including 
hundreds of resellers specially trainer! for your market. 

All said, the Compaq Professional Workstation is unlike 
any workstation you’ve ever used before. Which, of course, is 
exactly the point. For more information on Compaq 
workstations or Distributed Access, visit us at 
w r w r w.Compaq,com or call l-800-318-7774, 

Sc what's under the hood? 1—2 200MHz Pentium* Pro processors with NT 4.0, a 226K cache , up to 212MB 
of ECC DIMM memory, an Ultra-Wide SCSI controller, and advanced 2D/3D graphics accelerators , 

COMPAQ. 

Has It Changed Your Life Yet? 
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Dr Dobb's 

Distributed Objects Development CD-ROM 



The latest in distributed 
object technology, including languages, 
libraries, and environments 


Programming distributed systems using traditional tools is both complex 
and error prone. That's why the editors of Dr. Dobb's assembled this 
collection. Using this CD-ROM will enable you to build reliable 
distributed, object-oriented applications. And since the Internet and 
World Wide Web are rapidly increasing the demand for distributed 
applications, these tools and utilities are at the very heart of this 
technology, 

This CD-ROM contains over TOO megabytes, featuring: 

• Arjuna 3.3.2— A robust 0-0 tool for building fault-tolerant 
distributed applications out of C++ programs 

• Shadows —Creates Worid Wide Web Arjuna applications 

• Interlanguage Unification System (ILU>— A powerful programming 
model for distributing applications via an Interface Description 

• Obliq— An 0-0 scripting language supporting distributed computation 

• Visual Obliq— The World Wide Web version of Obliq 

• Phantom —A stand-alone, interpreted language for developing large-scale, 
interactive, distributed applications 

• Distributed Python— A portable, interpreted, 0-0 language which is 
extendable 



* Hector— A framework for providing open negotiations and interoperability for 
applications 
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I 
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Please send my CD-ROM today, I understand that I have a full money-back guarantee. 

Distributed Objects Development CD-ROM......$39.90 

Please add sales tax in the following states: CA (8.5%), GA (6%), IL (6.25%), KS (6,9%), NY (8.25%), 

TX (8.25%), Canada (7% GST). S 

Shipping ($2.00 for each CD-ROM shipped in USA/Canada, $10.00 for Airmail to all other countries.) $_ 
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copy today! 
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C PROGRAMMING 

Space Shuttles, Tomato Cans, and 
Teenage Daughters 

Al Stevens 



T he theme of this months issue is test¬ 
ing, so I'll devote die first part of this 
column to a reminiscence of my par¬ 
ticipation in a large test project. 
During the Apollo program, I was a cer¬ 
tified ACE operator. ACE, short for "Apol¬ 
lo Checkout Equipment/ was a configu¬ 
ration of consoles, computers, sensors, 
and transducers NASA used to test space 
capsules on the launch pad. After a one- 
week class, 1 was qualified to operate an 
ACE console. In movies about space ex¬ 
ploration. when the astronauts talk to Mis¬ 
sion Control t die guys in Houston always 
have crew cuts, sit at consoles, w ear white 
shirts and ties, chain-smoke cigarettes, and 
look either cool or worried depending on 
what's happening, I w r as not one of those 
guys. Mission Control is in Houston. 1 
worked at Kennedy Space Center; we test¬ 
ed the vehicles and lit the Irises, but Hous¬ 
ton ran the show— a gift from Lyndon 
Johnson to his constituents. 

Despite my certification, l never got to 
sit at an ACE console. They sent me to 
school to learn the system so that 1 could 
write programs to support it. Here's how 
it worked. Imagine a console like the ones 
that you see in die movies. Imagine me 30 
years younger with a crew cut, sitting at 
die console. Smoking a cigarette. Looking 
cool. Because nothing ever goes wrong on 
my watch, Or when it does, I’m still cool. 

The console has buttons and dials for 
input, and gauges and lights for output. 
The input and output devices are con¬ 
nected to a computer. The computer can 
sense when I press a button or change a 
dial s setting. The computer can turn die 
coasole's indicator lights on and off, and 
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position the needles in the gauges. 

Ncm imagine an array of cables that 
hang out the back of the computer. They 
are connected to D/A and A/D convert¬ 
ers in the computer The other ends are 
connected to sensors and transducers that 
can themselves be connected to some¬ 
thing— typically a space capsule or 
launch vehicle—that is to be stimulated 
and tested. The computer reads the dig¬ 
ital values converted from the sensors' 
analog data and writes digital values to 
be converted into analog values for the 
transducers to emit. 

t am imagining this configuration along 
widi you because they never let me actu¬ 
ally see it. You had to look like Ed Harris 
or Gregory Peck to be allowed in die room 
with the computer and consoles. I was 
more die Rick Moran is, Wally Cox type. 
(Hunk herd actors selected from two gen¬ 
erations so that readers from both gener¬ 
ations can relate.) 

In the space program, every launch is 
unique. Space exploration is an ongoing 
R&D activity, a never-ending management 
of crises, so die configuration of every 
vehicle is different in one w r ay or anoth¬ 
er from those that precede it. Conse¬ 
quently, the procedures for testing a ve¬ 
hicle had to be custom-designed and 
custom-built for each particular launch. 
A complex table of parameters told the 
ACE computer w hich transducer values 
to change when the ACE operator pressed 
a console button or changed a dial and 
what console indicator to change based 
on the values read by the sensors. The 
sensors and transducers w-ere connected 
to the vehicle at appropriate test points. 
A crew-cut person called the Test Con¬ 
ductor directed everything from a test pro¬ 
cedure script while the crew-cut ACE op¬ 


erators punched the buttons, turned die 
dials, and read and reported the resulLs. 
My role was to write programs on a dif¬ 
ferent computer (which I was allowed to 
see) to generate die test procedure scripts 
for the Test Conductor and the test pa¬ 
rameters for the ACE computer. 

Pure oxygen and sparks don’t mix. In 
January 1967. three astronauts perished in 
the infamous Apollo fire during such a 
test, and new r occupations resulted in the 
space program. Spin doctors. Blame 
shifters. Fault deflectors. The darkest six- 
rnonlh period in my professional memo¬ 
ry followed, and 1 left the space program 
not to return for 13 years. 

History repeated itself in January' 1986 
w ith the Challenger accident. 1 wasn't in¬ 
volved with the vehicles anymore, but I 
watched every launch. Still do. It is inter¬ 
esting to observe one significant differ¬ 
ence between those two moments in his¬ 
tone A cultural difference. After die Apollo 
fire, there w r ere no jokes. But something 
happened to the American sense of hu¬ 
mor in the interim. Somewhere between 
Gregory’ Peck and Rick Moranis, we turned 
to humor as a means of dealing with the 
emotionally unacceptable. Today, every 
national tragedy is followed almost im¬ 
mediately by a spate of jokes. Take it from 
me, you can’t watch seven people get 
blown to Kingdom Come without being 
changed, and you can't see anything fun¬ 
ny about it. 

NASA still tests everything, of course, 
and they look for innovative, efficient 
ways to .solve the unique problems of test¬ 
ing things diat are headed for space. In 
the 1980s, the emphasis turned to Shut¬ 
tle payloads. A Space Shutde carries car¬ 
go-— its payloads—into space. That’s its 
purpose, and, typical of space exploration, 
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every launch has a unique payload con¬ 
figuration. Ultimately, if budgets return, 
the Shuttle will be used to carry pieces 
of the Space Station to where astronauts 
can float around and assemble the Sta¬ 
tion like a huge orbital erector-set pro¬ 
ject. All those parts and pieces will be 
manufactured by different companies in 
different locations. Specific components 
will join one another in a Shuttle’s cargo 
bay to be ferried into orbit. It costs a lot 
of money to put something into orbit. 
Anything that goes up needs to be test¬ 
ed thoroughly to ensure that we re not 
wasting fuel and rockets and time by tak¬ 
ing junk into space. Every payload com¬ 
ponent needs to be tested at die factory, 
in the payload processing facilities, on the 
launch pad, and in orbit. 

One of NASA's goals was to extend the 
old ACE concept so dial, rather than use 
a file of cryptic parameters, a computer 
could run an interpreted language dial ex¬ 
pressed the rest sequence in procedural 
program code. They called tins concept 
the Space Station Operational Language 
(SSOL). The idea was dial a common lan¬ 
guage could be hosted by different plat¬ 
forms to run the same program to test a 
component at different locations with die 
same results. Il would have the control 
constructs of a structured programming 
language with the ability to directly ad¬ 
dress hardware registers to control die I/O 
devices, Sound familiar? Sounds like C 
Furthermore, the language had to lie in¬ 
tuitive so that engineers, installers, and as¬ 
tronauts who do not wxite programs all 
the time could still use it. Nope. Does not 
sound like C. 

I got involved because of my C back¬ 
ground and because, true or not, C was 
widely touted as the only portable pro¬ 
gramming language extant C was a like¬ 
ly candidate, not to be SSOL, but to im¬ 
plement SSOL to run on various platforms, 
C++ w as not w ell know n outside of AT&T 
at the time, but based on what 1 liad read 
about SmallTalk, 1 was pushing for an ob¬ 
ject-oriented approach for SSOL, an in¬ 
terpretable extension to a C-like syntax 
without the C gotcbas that trip up even 
veteran programmers from time to time. 
Nobody really knew what I was talking 
about. Neither did 1 at the time. As it turns 
out, 1 was talking about Java. 

The SSOL project eventually faded into 
obscurity as budget cuts took their toll on 
the Space Station program. (SSOL became, 
so to speak, S.O.L,) The results of tire 
study were filed for later resurrection 
should die money ever start flow ing again. 
When that happens, when we decide 
again to fund and follow our natural im¬ 
pulse to explore new worlds (after we bal¬ 
ance the budget, reduce the deficit, re¬ 
form campaign financing, eliminate war 


and world hunger, save Social Security and 
Medicare, sanction same-sex marriage, and 
forget about O J. Simpson), the SSOL pro¬ 
ject, or something like it, will l>e resusci¬ 
tated because the problems remain to be 
solved. 

One of the obstacles in that project was 
our lack of, not vision, but forward- 
looking visibility. NASA planned the Space 
Station to be a 30-year program. We were 
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charged with defining a programming lan¬ 
guage diat w ould remain relevant for that 
duration. But when we considered how 
programming had changed in the prior 30 
years, it seemed impossible that anyone 
could predict in 1987 what programming 
would l>e like in 2017. Now, in 1997, the 
suite of programming has already changed 
in ways that were totally unforeseen then. 
Given the recent research being made in 
visual programming, I'd love to get an¬ 
other crack at that language. 

MIDI Potential 

ACE w r as a huge process-control system 
applied to solve a test-bed problem. Pro¬ 
cess control conjures images of many 
things. Robotics. Real time. Embedded 
systems. I always imagine a conveyor 
belt moving tin cans through the facto¬ 
ry. One part of the process dumps toma¬ 
toes into the cans. A second stage seals 
the cans, A third pastes labels on the 
cans, and so on. 

That rendition suggests the traditional, 
pre- 1980s fear that computers are replac¬ 
ing workers. Years ago, w hen someone 
asked what I did for a living, I would say 
that I was a computer programmer. That 
response was inevitably met with a litany 
of complaints about how computers were 
putting people out of work, Eventually, 1 


learned to keep my mouth shut. Years lat¬ 
er, when computers entered the main¬ 
stream and people became accustomed 
to having them around, I relaxed and once 
again Ixgan admitting my profession when 
asked. Now r my response is met with a 
detailed description of the other person’s 
latest PC acquisition and a request that I 
drop by one day next week for a drink 
and, oh by the wav, maybe I could help 
install Windows 95. Eve got to learn to 
keep my mouth shut. 

A process-control computer senses and 
commands the components of an assem¬ 
bly line. A well-formed process-control 
system is as generic as the ACE system. 
It senses generic events and knows how T 
to command generic control devices. A 
table of parameters— a program— tells 
the system what those devices are and 
how to enact the procedures of the par¬ 
ticular process. 

Recently, I watched such a process be¬ 
ing demonstrated on a TV program about 
Lhe technology of making movies. This 
particular segment was about sound ef¬ 
fects. Hie sound effects technician (artist, 
really) sat at two keyboards—- an elec¬ 
tronic 88-key piano keyboard and a PC 
keyboard. His 21-inch computer monitor 
displayed what was obviously a sequencer 
program, such as Cake Walk or Winjam- 
mer, running under Windows 95. A sec¬ 
ond video monitor displayed the action 
of the movie. The technician played 
notes—pressed keys—on the electron¬ 
ic keyboard and his sound system gener¬ 
ated sound effects. Not musical notes, 
mind you, but atonal, eerie sounds. He 
used combinations of notes to generate 
combinations of sounds to create the 
spooky sound effects required by the 
movie he w as supporting. 

This piqued my interest. While devel¬ 
oping MidiFitz (a real-time rhythm ac¬ 
companiment program that f published 
in this column last year), I gained an in¬ 
terest in die Musical Instrument Digital 
Interface (MIDI), which is the underlying 
technology that drives electronic music. 
That TV documentary was about an ap- 
plication of MIDI not related to conven¬ 
tional music at all (Unless you, like Drac- 
ula, think that sounds such as the howling 
of wolves are music.) A visit to the local 
newsstand revealed several magazines de¬ 
voted to electronic music and musical pro¬ 
ductions, Notable among them is Key¬ 
board magazine, another Miller Freeman 
publication. There are several others. They 
feature articles mainly about the technol¬ 
ogy, but include a lot of photos and in¬ 
formation about the performers as well. 
Like the crew cuts of 30 years ago, these 
guys all tend to look alike. They frow n a 
lot, eschew shirts with sleeves, and sport 
earrings, body piercing, and tattoos. You 
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(continued from page 98 ) 
might think they are cool now, but wait 
until one of them is at your door to take 
your teenage daughter to the prom. 

What I learned from these magazines 
comes as no surpri.se to the cognoscenti, 
that MIDI Is the process-control technol¬ 
ogy that drives not only the drum ma¬ 
chine, but the lights, smoke, lasers, and 
anything else electro-mechanical associ¬ 
ated with a rock concert extravaganza. My 
teenage daughter once played one of her 
albums for me and went on and on alx>ut 
the production effects at the concert she 
attended. In the finale, she said, the band 
went berserk and smashed all their in¬ 
stalments on the stage. 1 listened to the 
album and opined that they had it back¬ 
wards; they should've smashed those in¬ 
struments before they were allowed to 
play them. She responded with a H Faw- 
ther!" and left the room. 

The sound-effects Lech on the TV doc¬ 
umentary had combined several MIDI and 
PC components to construct a sound- 
effects workbench. He used waveform 
tools to build the individual sounds. Then 
he loaded these sound files into a musi¬ 
cal sampler, which is normally used to 
Store the sampled recordings of real in¬ 
strument notes, lie assigned the samples 
as patches (voices) of the virtual MIDI in¬ 
struments. Then, when he played notes 
on the keyboard, sound effects came out 
instead of music. 

MIDI Fundamentals 

MIDI is an electrical specification and a 
protocol. The most remarkable tiling about 
MIDI is that in an unprecedented spirit of 
cooperation, an entire industry embraced 
the MIDI standard without being forced 
to by market pressure. 

When you press a key on a MrDl key¬ 
board, the keyboard sends a three-byte 
serial data packet to its MIDI Out port. 
The keyboard might also generate audio 
sounds to synthesize the notes of an or¬ 
gan or an acoustic piano, but that action 
is unrelated to the MIDI scenario. The first 
byte of the packet identifies the event and 
a four-bit channel number. The event is, 
in this case, the Note On message. The 
second byte identifies which note you 
pressed. Keyboards have 88 keys, and 
their notes are assigned the values 21 to 
108, The third byte of the MIDI-event mes¬ 
sage packet contains a value called the 
velocity, which numerically represents how 
hard you pressed the key when you 
played it. 

When you release the key, the key¬ 
board sends a corresponding Note Off 
message. The piano's controller devices, 
such as the sustain pedal and pitch blend 
wheel, send controller messages when 
you use diem. 


MIDI includes other messages to signal 
the start and stop of a performance, dock 
synchronizing events, and so on. 

You can connect a keyboard's MIDI Out 
port to any device that has a MIDI In port. 
Many keyboards have a MTDI In port. If 
you connect two keyboards, the notes you 
play on one are heard dirough the audio 
playback of the other. 

Coordination of all these messages into 
a performance is die job of a sequencer 
device, wliich is usually a program run¬ 
ning on a PC or Mac. All the instruments 
are connected to the sequencer in a daisy 
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chain or in a star network. Tile sequencer 
operator (a person) assigns each instru¬ 
ment device to one of the 16 channels, 
and die sequencer program assigns one 
of die standard MIDI voices to each of die 
instrument channels. There are 128 stan¬ 
dard voices called “patches," and diey are 
organized into instrument groups widi one 
set of voices for pianos, another for strings, 
and so on. The drum machine has its own 
set of patches. 

Sequencer programmers (people) use 
Lhe sequencer program to build Stan¬ 
dard MIDI Format (SMF) files contain¬ 
ing tracks of MIDI events, with each 
track assigned to a channel. The SMF 
file also records data related to the over¬ 
all production, such as time signature 
and tempo. (Contemporary sequencer 
programs can also mix audio in with the 
MIDI events, but that technology is out¬ 
side the MIDI standard and invol ves pro¬ 
prietary file formats.) 

During playback, the sequencer pro¬ 
gram reads the SMF file and sends the 
MIDI event messages to the MIDI de¬ 
vices via the sequencers MIDI Out port. 
Each device reacts only to the events as¬ 
signed to the device's channel, which is 
assigned by the system operator (one of 


the musicians, usually) when he or she 
sets up the system. The MIDI system 
plays the production, and die live mu¬ 
sicians jump around the stage and play 
along, adding the human dement to the 
performance and exciting your teenage 
daughter to dangerous levels. If it is 
done well, the audience can imagine 
that a 30- piece orchestra and several 
lighting and effects technicians are hid¬ 
den away backstage. 

So, the studio and the stage and the 
factory have a lot in common. It is told 
that a musician showed up for a record¬ 
ing date to find 30 other musicians set¬ 
ting up in the studio for the session. The 
newly arrived musician looked around 
and said, U I hope you people realize that 
you are putting three sequencer opera¬ 
tors out of work." 

MIDI versus Process Control 

Back to the factory. Consider the cost of 
process-control peripherals and their in¬ 
terfaces in the computer. Might there Lie 
something already in place that could do 
the same job? The Mac has MIDI con¬ 
nectors built in. Every PC with a Sound¬ 
Blaster or compatible sound card has MIDI 
In and Out hardware ports. All you need 
Ls an adapter cable that takes die signals 
from the game port adapter to corre¬ 
sponding MIDI In and Out five-pin DIN 
connectors. Turtle Beach includes such a 
cable with its sound cards. The Sound 
Blaster MIDI Interface Adapter Ls an extra- 
cost option. These adapters are not just 
cables, by the way. There are some built- 
in electronic components. 

Windows 3.1/95/NT have built-in MIDI 
drivers and applets. Sequencer programs 
are readily available. 

Suppose that you built your factory de¬ 
vices or your payload-testing devices or 
the auto-animatronic figures at your dieme 
park with MIDI interface hardware. You 
could orchestrate an assembly line or a 
widget test or the Gettysburg Address with 
an electronic keyboard and a sequencer. 

What are the advantages of using MIDI 
input/output hardware for process con¬ 
trollers instead of other standard inter¬ 
faces, such as the serial port? The main 
advantage is software. The drivers are 
built into the operating system. Se¬ 
quencers are plentiful and inexpensive. 
The SMF file format is standard. You can 
play your sequence through the Media 
Player applet that comes with Windows. 
You can simulate input devices with a 
standard MIDI keyboard. 

What are the disadvantages? One might 
be bandwidth limitations. Another might 
be die absence of error detection and cor¬ 
rection. 

Electronic musicians have come to know 
and work with the limitations of the MIDI 


100 


Dr. Debt's Journal, February 1997 







bandwidth. The speed of the sequencer 
computer is a factor The timing of MIDI 
messages is a function of die tempo as¬ 
signed to die performance, which essen¬ 
tially throttles die data rate. The bandwidth 
to support that data late is a function of 
how many devices are in the network, 
how many notes typically need to be 
played on those devices simultaneously, 
and whether the network topology is a 
daisy chain or a star 

MIDI is a real-time protocol, and, as 
such, it has no built-in error detection 
and correction, It's a lossy protocol in 
that it doesn’t really matter if an occa¬ 
sional event gets lost. If you miss a cel¬ 
lo note from somewhere deep inside a 
symphony, no one notices, or, if they do, 
the consequences are only aesthetic — 
assuming that they are not employed as 
music critics. There are no ACKs and 
NAKs, no CECs or checksums, and no 
retransmitted messages. You might stop 
and replay a passage wken you are prac¬ 
ticing, but on-stage you stay cool, pre¬ 
tend the mistake didn't happen, and just 
keep playing. 

You can miss a wolf howl, cello note, 
or tomato can, or your autoanimatronic 
Abe Lincoln can skip a gesture, but die 
consequences of missing a critical voltage 
reading or hatch configuration could be 
dire. Therefore, MIDI s feasibility as a pro¬ 
cess control or resting protocol depends 
on the real-time requirements of die events 
and the critical nature of each one. 

MIDI Xchg 

I wondered just how hist and how accu¬ 
rately a computer could send MIDI mes¬ 
sages to another computer without data 
loss. To that end, 1 wrote MIDI Xchg, the 
program included with this column. Its 
purpose is to stress ihe MIDI data stream 
by sending event messages from one de¬ 
vice to another as fast as possible. I used 
Visual C++ 4.2 and Windows 95 for the 
test platform. 

To run MIDI Xchg, connect the MIDI 
In port of one PC to the MIDI Out port 
of the other and vice versa. Run the pro¬ 
gram in both PCs. Choose the MTDI/De- 
vtces menu command in both PCs and 
select MIDI devices on the Select MrDI 
Devices dialog box, shown in Figure 1, 
to correspond with the PC's physical ca¬ 


ble ports rather than the sound card syn¬ 
thesizers. Choose the Receive command 
on the MIDI menu of one of the PCs. 
Then choose the MIDI/Send Da La com¬ 
mand on the other. The sending PC be¬ 
gins sending Note On messages to its 
MIDI Out port. The data stream consists 
of repeated loops of 128 notes in die se¬ 
quence of 0 to 127 so that the receiving 
PC can determine if any notes are miss¬ 
ing in die stream. Wait a few seconds and 
choose the MIDI/Stop Sending command 
to stop the data stream. The receiving 
computer reports the number of events 
received, die number of notes dropped, 
the number of events per second, and the 
approximate effective baud rate just to 
provide a familiar measure with which to 
compare the performance. Figure 2 shows 
the application window after a session. 

The MIDI Xctig Implementation 

MIDI Xchg is an unremarkable MFC ap¬ 
plication with no document/view archi¬ 
tecture but with application and frame 
classes. There are ten source-code files 
and a resource file. The entire project is 
available electronically; see "Availability," 
page 3. The application and frame class¬ 
es each have headers and cpp files. 1 
adapted the Midiin (see Listings One and 
Two; listings begin on page 113) and 
MidiOut classes (Listings Three and Four) 
from MidiFitz lor this project. Those class¬ 
es each have a header and a .cpp file, 
and those are the classes 1 11 discuss here. 
The two classes encapsulate enough of 
the Windows MIDI API to support this 
test. When the program instantiates the 
two objects, their constructors call the 
midi OutGetNu mDevs and mid tin Get- 
NumDeus API functions to determine the 
number of MIDI devices available. Both 
classes have a DeviceList member func¬ 
tion that loads a CListBox object, passed 
as a reference argument, with the names 
of the installed devices. MIDI Xchg's Se¬ 
lect MIDI Devices dialog box uses these 
functions. 

Mien you select MIDI devices, the pro¬ 
gram calls the Change Device member 
function, which closes the current devices 
and opens the new ones, The midilnOpen 
API function has a parameter diat Ls the 
address of a function for the system to call 
when a MIDI in message is received. The 
Midiln class includes a Register MIDI- 
Function member function so that the 
program can provide the address of its 
MIDI-message input function. This func¬ 
tion must be called ahead of Change- 
Device so that the Midiln object has a 
function address to provide to midiln¬ 
Open from ChangeDemce 

When the sending PC begins sending 
event messages, it first sends the MIDI start 
event message by calling MidiOut-Start- 



Figure 2: MIDI Xchg application 
window . 

Message When you choose the Stop Send¬ 
ing command, the program calls MidiOut ■ ■ 
StopMessage to send the MIDI stop mes¬ 
sage. The receiving program uses these 
two messages to time the data flow. 

Conclusion 

While working on this program, I learned 
several things about the way that the 
Win32 API handles MIDI. First, it buffers 
MIDI input messages so that if the pro¬ 
gram does not get around to processing 
them right away, they come in later. I was 
using the callback window option rather 
than the callback function for MIDI input 
messages so that I could post their re¬ 
ception In the program's main frame client 
window. You can't call most system func¬ 
tions from a callback function. The latent 
Win32 overhead for receiving the mes¬ 
sages and displaying them was high 
enough that the messages backed up in 
the receiver. When 1 stopped the trans¬ 
mission, there was a burst of backed-up 
messages displayed, and the lasL bunch 
of them had a lot of missing messages. 

By changing to a callback function and 
using that procedure to count the mes¬ 
sages received and the messages dropped, 
l eliminated the bottleneck, and the MIDI 
Xchg receiver was able to receive and pro¬ 
cess as many messages as the MIDI Xchg 
sender could send. 

The sender sends the messages in a tight 
loop by calling the MidiOut::SendEvent 
function with the Note on messages al¬ 
ready formatted. That function calls the 
API's midiOutShortMsg message. It be¬ 
came apparent from the results that midi- 
OutShoftMsg does not return until the mes¬ 
sage has been sent, or, at least, waits until 
the previous message has been sent and 
the output port Is available. That strategy 
effectively enforces the MIDI data rate, 
which turns out to be something close to 
28K baud, about 1040 events per second, 
which ought to be plenty fast enough to 
paste labels on tomato cans. 


DDJ 

(Listings begin on page 113-) 



Figure 1: Selecting MIDI devices. 
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skills and experience with PCs, Assembler, C, C++, Windows, and 
DOS 

emoil your resume to job5@numego.c0m, or send it to; 

NuMego Technologies 
9 Townsend West 
Noshuo, NH 03063 
Att: Human Resources 



You’re the best. We’re the best. 
Let’s get together. 


CMC is a medium large software house, based in the 
Netherlands, the UK and Germany, CMC Is well on Its way be¬ 
coming one of the largest independent IT companies in Europe, 

The Advanced Technology division in the Netherlands is 
expanding rapidly and, as a consequence we are looking for 
more consultants. 

We need the best project managers, the best technical 
project leaders, the best business consultants, the best infra¬ 
structure specialists and the best software engineers. In brief: 
we are looking for you. if you are a (Dutch-speaking) profes¬ 
sional, then join the other 3,000 CMC people who are currently 
helping our customers expand their business, solve IT problems 
and are making a great career for themselves. 

We work hard, we play hard and we pay above market- 
rates. In a nutshell, this is the most accurate way to describe 
how we succeeded as a profitable independent company for 


over 30 years in the fastest growing marketplace in the world. 

You're the best and we’re the best to work for, according 
to an independent market analyst who publishes a yearly 
report called 'The best 25 IT-companies to work for'. In this 
list, CMC is mostly ranked first or second. Are you interested 
In what we do? Then visit our website, and form your own 
opinion. 

Do you live in the Netherlands or are you planning to do 
so in the near future? Let us know and send your CV by mail, 
E-mail, fax or snaii-mail, and well take it from there. Of course, 
you can also call us or use the recruitment form on the CMC 
homepage. CMC Finance, division Advanced Technology, P.O, 
Box 133, I ISO AC Amstelveen, The Netherlands. Rob Labordus, 
Associate Director, 

Phone ++31 20 50 33 000, Fax ++31 20 50 33 01 I, E-mail 
rob, labordus@cmg.nl CMG^ Internet address: http://www.avg.nl 
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JAVA Q&A 


How Do I Access a SQL 
Database from an Applet? 



Cliff Berg 


■ n the past year, a lot has been written 
I about the usefulness of the Web as an 
I alternative to conventional custom 
I software-based solutions for distribut¬ 
ing business and other information . In the 
traditional approach, a vertical applica¬ 
tion is programmed using embedded SQL 
or some other technique, and application 
programs that access die database are dis¬ 
tributed to users within a corporation. 
One disadvantage of this approach is that 
the application has to be redistributed ev¬ 
ery time it is changed. The web-based 
alternative instead relies on the simple 
(but powerful) HTML publishing model 
for the user interface and on centrally 
maintained CGI programs for accessing 
the database and making the data avail¬ 
able to web pages. 

While this approach is an improvement 
in cost and flexibility over the deployed 
application approach — and much has 
been written about the cost advantages 
of doing things this way— it suffers from 
the very limited feature set provided by 
the CGI protocol, which is primarily a 
transaction-oriented mechanism in which 
a server program accepts a parameter 
stream from the user’s web-page form, 
then generates a new web page as out¬ 
put, and possibly accesses a database 
along the way. Tools such as Javascript 
make it possible to perform local pro¬ 
cessing prior to sending the query to the 
database — for example, to do checking 
on fields—* but Javascript is a poor choice 
for large applications. Because it does not 
provide a mechanism for reusing code, 
commonly used routines must be cut-and- 
pasted into each place they are needed. 

A better approach is to utilize the dis¬ 
tributed programming model of Java, so 
tha t we can have the best of both worlds: 
a flexible and highly interactive (even real- 


Cliffi vice president of technology of Digi¬ 
tal Focus, can he contacted at cliffbdfa 
digitalfocus.com . To submit questions, 
check out the Jam Developer FAQ Web site 
at http://wwwAigitalfocm.cotn/fa 


time) UI, but with the low cost of a web- 
based approach. The need to use CGI, 
which is notoriously difficult to debug, is 
also obviated. 

JDBC 

Java 1.1 w ill incorporate a package called 
“java.sql," which provides a standard Java 
binding for accessing an ODBC-compliant 
database. This package is available now 
as a beta release from Sun's Java site 
(http://java.sun.com/). To use it, all you 
need is a JDBC/ODBC-compliant driver. 
Eventually, such drivers will be available 
in Java-only versions. At the moment, most 
are implemented with Java native methods 
which, in turn, call ODBC driver libraries 
on a platform-specific basis. Since native 
methods cannot be called from within a 
remotely loaded applet in most browsers, 
this limits these drivers to applications that 
mn on the same host as the database. This 
is not practical for a web application. 

The solution implemented by many driv¬ 
er providers Ls to use a special .server pro¬ 
gram that resides on the same machine as 
the database and fields remote JDBC re¬ 
quests, then calls the required ODBC driv¬ 
er functions. To achieve this, the JDBC 
driver {which runs within the applet) must 
be designed to communicate with this spe¬ 
cial server program. 

In this column, I'll use a driver provid¬ 
ed by XDB Systems (available from http: 
//www.xdb.com/). All of the code will 
use the standard JDBC packages. The only 
vendor-specific impact on the program is 
the instantiation of XDB T s driver Mast ven¬ 
dors, including XDB, also provide a rich 
set of user-interface components, written 
in Java, to assist in the construction of an 
interactive web-based database applica¬ 
tion, Since those tools are vendor specif¬ 
ic, however, I won't use them for this col¬ 
umn and will instead concentrate on the 
JDBC aspects. 

A Query Tool 

For a demonstration applet, I’ll create a 
query tool that allows you to enter any ar¬ 


bitrary SQL query and displays the result¬ 
ing table in a separate browser w r indow, 

I could simply sprinkle JDBC calls 
throughout the code directly, the way you 
might have embedded SQL wherever you 
want to make a query. Database vendors 
seem to think that developers w-ant to use 
their interface in this w r ay. It is not good 
programming practice, however. For ex¬ 
ample, suppose you want to develop most 
of the application independent of the 
database, and merely have a test stub, 
which simulates a database connection. If 
there are database calls everywhere, it will 
be impossible to test the application as a 
whole without access to the database— 
a poor strategy. It is better to encapsulate 
database access in a single class. You 
could then have a test version of this class 
and a real version. The test version’s meth¬ 
ods could return simulated data, where¬ 
as the real version's methods return live 
data. 

five encapsulated my use of java.sql into 
a class called QuerySvcsImpl that imple¬ 
ments an interface called QuerySvcs. For 
testing, I am free to have a test version of 
this class, called QuerySvcsTestlmpl. 

QuerySvcs (see Example 1) specifies 
these methods. Each of these may throw 
java.sqiSQLException, which would in¬ 
dicate an error was detected by the driv¬ 
er. These methods are implemented in 
QuerySvcsImpl. The initConnectionf) 
method checks if a driver has been in¬ 
stantiated yet (static component), and if 
one has not, calls new JetDriverf )— 
XDB’s driver object. This is the last time 
you have to refer to the client-side driv¬ 
er object. initConnection() also performs 
Example 2, 

The java.sql.DtiverManager class has a 
static method called getConnectionf) (Ex¬ 
ample 2) that takes three parameters: a 
dataset URL, database user id, and pass¬ 
word, The URL is the concatenation of the 
driver protocol, host, and database dataset 
name. JDBC defines a driver-protocol syn¬ 
tax composed of two parts separated by 
a colon. The first part is simply “jdbc/ 
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while the second pan specifies the name 
of die driver and is vendor specific, tn diis 
case, the full protocol is “jdbc:jet.jettp:”. 

The host is normally the Internet DNS 
name or the IP address of the database 
host machine. For example, it could be 
www.so7newhere.com, or 20%123*456J89. 

If you are testing your database on your 
own machine, however, you will proba¬ 
bly want to specify "loopback” if your ma¬ 
chine's TCP/IP stack has loopback sup- 
port (Windows 95 does not; NT does). 

However, note diat Netscape Navigator re¬ 
quires you to have a real connection, and 
will not like loopback. If you are testing 
on Windows 95 and only have a dial-up 
connection, you can pul code into your 
applet to get your dynamic IP address with 
the jam netJnelA ddress.get LocalHosti ) 
method and use this IP address in your 
getConmctionO call—all this to make 
the browser happy! 

The getMelaDataO method obtains a 
database meta data object that can lx? used 
to query information about the status of 
die database. For example, from a Data- 
haseMetaData object you can obtain the 
dataset URL, the database product name 
and version, and the name and version of 
the driver. 

The selectO method executes a SQL 
query against the database; see Example 
3. As you can see, you first have to cre¬ 
ate a jam.sql,Statement object before you 
can perform a query. You then call 
execateQueryC ) against the Statement ob¬ 
ject, passing it the SQL string to evaluate. 

The result that is returned is a java.sql 
.ResultSet, which is essentially a currency' 
pointer on the query result. No data is ac¬ 
tually returned to die client until die Result- 
Set is traversed, 

vselectf ) does all this, then traverses the 
ResultSet, and converts it into a java, util 
. Vector object, with each element of the 
vector consisting of an array of objects 

public java.sql.Connection initConnectionC); 
public void closeConnectionO; 
public String toHTML(ResultSet r); 
public Vector vselect(String eqline): 
public ResultSet select(String sqline); 


Example 1: Methods specified by Query Svcs. 


con = Dr iverManager. get Connect ion (protocol + ’7/" 
+ host + '7" + dan. uid. pwd) ; 
dbmd = con.getMetaUata(): 
con.setAutoCommit(true) s 


Example 2: Executing initConnectionC). 


Statement stmt = con.createStatement(3; 
r = stmt.executeQuery(aqline); 


types DATETIME and SMALLDATETIME 
are mapped by most ODBC drivers to 
the ODBC type TIMESTAMP, which maps 
to java.sql. Timestamp. While you can¬ 
not create more than one TIMESTAMP 
field in a record, there is no such re¬ 
striction on the DATETIME types, and so 
you can, from your JDBC program's 
point of view, have more than one 
java.sql.Timestamp object in a record. 
This is useful for storing java. utiLDate 
objects, since java.sql.Timestamp derives 
from java .util.Date, and because some 
databases do not support DATE and 
TIME, but instead have a DATETIME 
type. Simply use the java.sql. Timestamp 
type in your program instead of 
java.util.Date, and you will be okay— 
the Timestamp object should work wher¬ 
ever a Date object is required. The only 
consideration is that java.sql Timestamp 
overrides java.util .Date's date parsing 
and toString( ) methods, and so it has 
different (more TIMESTAMP-like) rules 
for how it parses and displays date and 
time strings. Note that java,util.Date 
objects can only represent dates as far 
back as 1970; java.sql. Timestamp objects 
have this same limitation. If you want to 
represent dates beyond this, you may 
have to add an offset. Beware of a bug 
in the parsing of java.util.Date objects, 
which lias been fixed in Netscape's ver¬ 
sion of Java, but not in Internet Explor¬ 
er. This bug causes a date expressed as 
3/1/95 to be interpreted as April 1, 1995 
(no joke). 

The Bignum datatype is very inefficient, 
and should be used only where monetary 
values are represented or where exact pre¬ 
cision is required. 

The Browser Factor 

Sun made a mistake in making the sqi 
package part of' package java . Package 
javasqi will be a standard component of 


ResultSetMetaData nnd = r.getMetaDataf); 
int cc = rrod,getColumnCount ()\ 

int i - S; 
while (r,next()) 

C 

i++; 

applet.shovStatuef"Retrieving row M + i): 
Object[] oa = new Object[ccj : 
for (int j =0- j < cc ; j++) 

[ 

Object o = r.getObject(j+1) ; 
if (o srs null) o “ " n ; 
oa [j] = o; 

1 

v.addElement(oa); 


corresponding to the fields in each row 
of the result. This method is useful if you 
want to get the whole result and then do 
something with it, like graph it 

Example 4 is the core of vselectf). Thus, 
to find out how many columns are con¬ 
tained in the result, you can get the Resuti- 
SetMetaData object and then call get- 
ColumnCountO. Note that many of die 
ResultSelMetaDala methods can only be 
called once during the life of any Result- 
Set instance. 

What you've discoveied is drat the Result- 
Set.getObjectf j method involves a lot of 
overhead and results in very slow perfor¬ 
mance. Alternatively, you could use the 
JDBC type-specific methods of the form 
geKtypeX);, The disadvantage is that when 
using these, you must anticipate the type 
of each column in the result. 

The JDBC standard also provides for 
parameterized precompiled statements 
(java . sqiPreparedStatement) , which will 
result in faster performance if a select is 
executed within a bop. 

To put all this together into a query tool, 
I wrote an applet. Client.java (see Listing 
One, listings begin on page 113) that in¬ 
stantiates a text field for capturing the in¬ 
put query from the user. A button handle- 
EventO method retrieves this text, and 
passes it to my QuerySvcsseiecK ) method, 
which returns a ResultSet- l then call to- 
H1]ML( ) with this result set, to generate 
HTML output for die results window. I use 
the “javascript:" content protocol to dis¬ 
play die generated string of IITML state- 
ments: g et Applet Co ntexK ) . sh a wDoci t - 
ment(que ryS vcs , t oHTML ( result Set), 
‘DUTPUT_WINDOW”);. Figure 1 is the 
completed applet and Figure 2 is a results 
table generated by it. 

Notes about Data Types 

Table l lists some of the more useful 
datatypes. In addition, the Microsoft SQL 


Example 3: Executing the selectO method. Example 4: The core of vselectf). 
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SQL type 

Maps to Java Type 

JDBC Method 

VARCHAR 

java Jang. String 

getStringO 

CHAR 

java Jang. String 

getStringQ 

REAL 

float 

getFIoatQ 

FLOAT 

double 

getDoublef) 

INTEGER 

inf 

getlntQ 

DATE 

javasql.Date 

getDatef) 

TIME 

java.sql.Time 

getTimef) 

NUMERIC, DECIMAL 

java Jang. Blgnum 

getBIgnumQ 

TIMESTAMP 

javasql. Timestamp 

getVmestampQ 


Table 1: Data types. 


package java when JDK 1.1 is released. 
In the meantime, however, the fact that 
this package is pun of package Jam makes 
it impossible to load it into Netscape Nav¬ 
igator or Internet Explorer in a normal 
manner, A browser generally will not let 
you download any component of pack¬ 
age java from a remote source, for secu¬ 
rity reasons. Since package javasql is not 
incorporated into either of the aforemen¬ 
tioned browsers (and probably will not 
be until alter JDK Id is released), this 
means that package javasql is effectively 
inaccessible to a browser. 

A fairly ugly but usable workaround, 
until El is released, is to add javasql to 
the browser’s own class library. In the 
case of Netscape Navigator, as of this writ¬ 
ing. these classes are hidden in a ZIP hie 
called java_30. To put javasql into this 
ZIP archive, you must rename the archive 
to java 30 .zip, open it with a tool such 
as WinZip, add javasql immediately al¬ 
ter the other java packages in the file, and 
then rename the file back to its original 
name. For Internet Explorer, the proce¬ 
dure is similar, except that the ZIP file is 
called classes,zip, and it is in the \ Win¬ 
dows \ java \ classes d irecl ory, 

Now' that you have added javasql to 
your java_30, users of your applet will 
have to replace their Netscape java_30 file 
with yours. You can put it on the web site 
that serves the applet, with instructions 
about where to put it after it is down¬ 
loaded, While this is a little bit cumber¬ 
some, it is workable for an intranet ap¬ 
plication. 

An even better alternative is to use a 
product such as Marimba's Castinet 
(http: //wwvv. marimba, com/), w hich au¬ 
tomatically installs applets on a client sys¬ 
tem, Castinet does not have the same re¬ 
strictions that browsers have, because the 
assumption is that the user has approved 



Figure 1: Completed applet. 



Figure 2; Results table generated by 
applet , 


the applet and trusts its source. This kind 
of setup allows you to download new 
components of package java (such as 
java.sql). 

The complete code for the query tool 
is available electronically (httpi//www.dig- 
italfocus.com/ddj/code/; or see "Avail¬ 
ability," page 3). 

Conclusion 

The [DBG interface, combined with a suit¬ 
able driver, makes it easy to create 
portable database applications with Java. 
As of this writing, some installation Ls re¬ 
quired for users to use JDBC applets with¬ 
in a browser, but this obstacle will likely 
disappear with the next major round of 


browser releases. There are also alterna¬ 
tives to browsers. 

JDBC makes ti possible to make enter¬ 
prise data available, from dynamic and in¬ 
teresting Java applications, without re¬ 
quiring die developer to use precompilers 
or to write stored procedures: The full 
power and flexibility of Java is available. 
Further, these applications can be used 
with any database for which there are 
JDBC/ODBC or pure JDBC drivers, and 
most ODBC driver vendors are develop¬ 
ing or now provide JDBC drivers. Java has 
become a formidable business tool. 

ddj 

(Listings begin on page 113.) 


WARNING: Programmers in general have 
determined that without Opus Make your 
company's health may be seriously jeopardized. 


In today's fast-paced world, time to market is everything. So why risk your company's health 
using a slow and unreliable build utility"? You need Opus Make. It is the fastest, most full-featured, 
most reliable make utility on the market. Opus Make is designed to efficiently speed up your build 
process. You will develop your software faster, get il to market sooner and, in return, improve your 
company's health - and yours. Find out why Andrew Binstock says "Opus Make is the most 
compelling reason for not using the make utilities bundled with today's compilers" 


Opus Make version <M featw 
Makefile Compatibility: Processes Intersolv Configuration 
Builder™, Microsoft™ NMake and VC++, Borland Make™, 
and Alter makefiles. 

Version Control Support: Access source lites in Microsoft 
SourceSafe™, Burton Systems TUB™. Inlersolv PVCS™, and 
MK5 Source Integrity™ version control systems. 

Microsoft Visual G*+ Support: Opus Make integrates with 
VC++ 2.x and 4.x. 

Multiple Platform Support: 

DOS, OS/2, WinNL Win95, AtX, 
HP/UX. SCO, SunOS, Solaris. Irix, 
DEC AlphaNT, and Others. 




res include: 

Qlfier features: Multiple-directory 
support * Pattern-based inference rules * 

Multiple targets created from single 
source * Automatic and in-line response 
tiles * Queued shell lines ■ Object library 
maintenance * Conditional, looping and 
include directives * And much morel 

Opus MKNJF Vfi.1 included : MKMF is our makefile 
and dependency generator. II quickly builds and 
maintains your makefiles. II understands C-preprocessor 
directives and resource compiler files. If you hate building 
makefiles by hand this is the tool for you! 




Opus Solfware. Inc. * 1032 Irvin a Street, Suite 439 * San Francisco, CA 94122 
Phone. (415)485-9703 orflaa-240-fi7B7* Fax Hi5}495-9704 
Email: lnfo©opussoUware.ccm * Web http://www.opusso1lware.com 


Opus Make * 


CIRCLE NO. 323 ON READER SERVICE CARO 


Dr Dobb s Journal\ February 199 7 


105 






























































Designing and Using ActiveX Controls 
fully explains Microsoft's Component 
Object Model, ActiveX technology, and 
the Microsoft Foundation Class Libraries. 
It details ActiveX control automation 
with Internet Explorer, and discusses how 
to develop reusable components with 
Visual C++ and the MFC. You'll learn how 
to create controls ranging from simple 
ones for VBScript, Explorer, and the Web 
to complex ones such as graphical and 
nonvisual controls, Internet-specific con¬ 
trols, and async monikers. The enclosed 
CD-ROM contains over 30 reusable custom 
components created by the author, as 
well as all the source code discussed in 
the book. 

BOOK/CD $39.95 
ISBN: 1-55851-503-8 



M&T 1 

CM 

Subsidiary of 
Henry Holt and Co., Inc. 
HTTP WWW.MANDT.COM 


Available at Your Local Bookstore 


In Australia Contact 

Woodslane Pty, Ltd. 

7/5 Vuko Place 
Warriewood NSW 2102 
Australia 
61-2-9970-5111 
61-2-9970-5002 (Fax) 


In Europe Contact 

Pitman Publishing 
128 Long Acre 
London WC2E 9AN 
England 

44-171-379-7383 
261367 PITMAN G (Telex) 
44-171-240-5771 (Fax) 


In Canada Contact 

Fitzhenry & Whiteside 
195 Allstate Parkway 
Markham, Ontario, L3R 4T8 
(905) 477-9700 
(905)477-9179 (Fax) 


In Asia Contact 

Longman Singapore 
Publishers (Pte) Ltd. 

25 First Lok Yang Road 
Jurong Town 
Singapore 629734 
65-268-2666 
65-268-7023 (Fax) 




* I 


ALGORITHM ALLEY 

Scheduling Algorithms and 
NP-Complete Problems 



Oleg Kiselyov 


The term "NP* complete" refers to a family of problems dial 
are all roughly equivalent; if you could find a fast algorithm 
to solve one of these problems, the others would quickly fol¬ 
low. NP-complete problems are both extremely common and 
frustratingly difficult.. Many problems of the form “find the 
best/cheapesl/shori.est way to do X“ are NP-complete, and 
a last solution to NP- complete problems would revolution¬ 
ize such disparate fields as compiler optimization and airline 


scheduling- However, in lieu of such a breakthrough, the best 
way to deal with an NP-complete problem is usually to find 
a trick that will give you a “good enough” approximate so¬ 
lution. This month, Oleg discusses an NP-complete problem 
that he encountered in trying to schedule a chess tournament, 
and the approximate solution that made it feasible, 

—Tim Kientzle 


M any years ago, when 1 was still a 
chemist, t was approached by a 
scientist of the “old school” who 
didn’t like computers, To my sur¬ 
prise, he asked me for help in using com¬ 
puters to schedule a traditional New Year 
“blitz* chess tournament. That year, quite 
a few participants were expected, prompt¬ 
ing a switch to a Swiss system. In this 
method of conducting a tournament, the 
total number of games to be played is 
specified in advance and is smaller than 
n*(n— l)/2, where n is the number of par¬ 
ticipants. Consequently, not everybody 
would end up playing with everybody, 
To be fair, the scheduler would have to 
match partners of equal skill, provided 
they hadn't played already. Keeping track 
of who played whom and (at the same 
time) trying to find partners of similar 
strength would quickly become a pain. 
That’s why he thought a computer might 
be of some help, 

In the actual setting, there were about 
20 participants, and 10 rounds were played. 
In each round, partners played two five- 
minute games (one person plays white, an¬ 
other black, then they switch). So, one can 
score 0 (lost both games), 1/2 (lost one, 
tied the other), and so on up to 2 points 
(won both). After a round was over, the 
results were entered into a computer that 
had to come up with the pairings for die 
next round. The players scheduled in the 
next round must not have played each oth¬ 
er in previous rounds; moreover, their 
scores should be as close as possible. 


Oleg is a computer scientist/software de¬ 
veloper with Computer Science Carp. 
(CSC) in Monterey , California http:// 
pobox, comZ-oleg/fipZ. 


For example, consider the tournament 
in Table h Eight people who have already 
played tiiree rounds. In die first round of 
the tournament, there are no constraints: 
No one has played a game, and everyone 
lias the same score (zero). Consequently, 
any schedule will do; for example, player 
2r—1 plays against player 2 i, with the num¬ 
bers being assigned randomly. After the 
round is played, a few leaders emerge, 
They’re pitted against each other in the 
next round, and so on. After the third 
round, the leaders are #1 and *5, but 
they’ve already played each other. Aiming 
to match scores as closely as possible, you 
could pair players #l-#4, #5-#7, and 
#3-#8- Tills leaves #6 and #2, but they have 
already played! You can see die kind of 
conflicts you have to resolve. With 20 play¬ 
ers, die situation becomes very tangled very 
quickly. 

Handling the Problem 

You can think about the scheduling prob¬ 
lem in terms of graplis. Consider a graph 
where each vertex represents a potential 
pair. For example, vertex 1-2 represents 
a pairing of players #1 and #2. Initially 
there are n*(n- 1)/2 vertices where n Is 
the number of players. As the tournament 
progresses, you remove vertices that have 
already played. Two vertices are con¬ 
nected if the two pairs can both appear 
in the same round; for example, vertices 
1-2 and 1-3 are not connected, since play¬ 
er *1 can't play player *2 and player #3 
at the same time. Vertices 1-2 and 3-4 
are connected There is a cost associated 
with each vertex; a disparity of scores of 
the two players. This cost is updated af¬ 
ter each round. Figure 1, for example, 
shows the graph corresponding to the sit¬ 


uation after the third round in our sam¬ 
ple tournament. The scheduling problem 
is reduced to finding a clique of a mini¬ 
mal cost in die graph. That is, find a set 
of n/2 vertices dial are all connected with 
each other (a clique of order n/2) such 
that the total cost (of all vertices in the 
clique) is minimal. It is obvious that a 
clique of order n/2 means that all n par¬ 
ticipants will play in the round. 

Finding a clique in a graph is, by itself, 
an NP-complete problem. But it pales in 
comparison with the requirement of find¬ 
ing a clique of minimal cost. A naive so¬ 
lution would be to consider all possible 
subsets of n/2 vertices of the graph, check 
to see if they all are connected with each 
other, compute the total cost, and pick up 
a subset with the minimal cost. The com¬ 
plexity of this obvious solution is far more 
than exponential in n. For example, in a 
tournament with 20 participants, you have 
to choose 10 pairs from 190 possible pairs. 
There are over 10 16 possible combinations 
to consider, a formidable number for even 
die most powerful supercomputer. 

Even if you want the exact optimal so¬ 
lution, however, you can do better than 
this. Assume for a moment that player #1 
has stepped out, and we have to sched¬ 
ule a round without him. Obviously, some 
other player has to take the round off, 
too. Suppose that for each i=2„n t you 
have come up with optimal schedules in¬ 
volving all players but i and L In graph 
terms, you found optimal cliques of order 
in/ 2)-l that don't contain vertices men¬ 
tioning 1 and L The cost of that clique 
would be cost(aU-UM). Suppose player 
#1 has shown up and wants to play the 
round after all. Rather than rebuilding the 
schedule from scratch, you can use the 
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You can waste your 
[HBH with rookies, 
theorists, or 
wannabes. 

Or you can learn 
from expert 
developers who 
work on real 
projects every day. 


NY 1 : ILL : 

S Y S V li M S cue 
D* li' V1 CIS D<fcl V liliS 
C LA.-S S S S 

Leu i-it lU’cui i h a nupevlt 
t/te "tic guys" ccU. 


Classes: 

|-# DEVELOPING FILE SYSTEMS 

(or WINDOWS NT - 5 day course 

WINDOWS NT KERNEL MODE 
DEVICE DRIVERS - 3 doy course 


Start Dates: 


1 i 


Seattle 

2/10/97 

2/10/97 

Washington, D.C, - 

3/17/97 

Palo Alla 

3/31/97 

4/2/97 

Boston 

S/5/97 

5/5/97 


1-888*677-4264 

Call far details and Fees. 

Or visit GSR's NT World at www.osr.com. 


O S R ‘ Open Systems Resources, Inc, 

■ 105 Rie IQ1A, Stiff* 19 

AmhersI, NH 0303 1 USA 
voice + I (603} 595-6500 
fax: *1(603} 595-6503 
e-mail: info@cur.cam 
web: www.osr.cojn 

fiXCOD X O L7 Jf £Xl»£CTHTlON5 


CIRCLE NO. 339 ON READER SERVICE CARD 


already-found partial optimal .schedules, 
add players *1 and i to them, and select 
the one with the smallest total cost. For 
each player i, the total cost is cosKall) - 
cost(aII-{1, ij) + costf{1, il), where costfilj]) 
is the disparity in scores between players 
i and #1. If players i and #1 have already 
played, put costflljl) to infinity. 

Tills technique is easy to justify; If the 
optimal schedule matches player *1 
against player i then the schedule with¬ 
out Lhese players also has to lie optimal 
(with respect to the remaining players). 
Otherwise, you can lower die cost of die 
original schedule, which would contradict 
the premise that it is optimal. To find die 
best partial schedules, you can repeal this 
algorithm recursively. This dynamical pno- 



Fignre l: Scheduling choice graph 
corresponding to Table /. Vertex cost 
is in parentheses. 


gramming algorithm—similar to the one 
used to solve the traveling-salesman prob¬ 
lem (TSP)—reduces the complexity some¬ 
what, to the order of (rc-l)2 n-] . The ori¬ 
gin of this estimate Ls easy to see; You need 
to consider all even subsets of the set of 
all players. Determining an optimal sched¬ 
ule for a subset (given optimal schedules 
for smaller subsets computed previously) 
takes no more than (rz-1) operations: 
adding a cost of a new pair and selecting 
die smallest term. For n=20 players, it 
should uike no more dian 10 7 operations 
to schedule a round, immensely faster than 
die aforementioned naive algorithm. 

However, Lius algorithm is fast because 
it caches the partial schedules. This cache 
Ls quite latge, several megabytes for n= 20, 
At die time, l only had a lowly PDP-11 to 
work with, so I wasn't able to use even 
this improved algorithm. 

Fast Approximation 

In practice, you do not need the perfect 
schedule—a reasonably good approxi¬ 
mation suffices. To speed diings up, I used 
a simpler approach. I first sorted all players 
by their scores, then tried to pick partners 
that were neighlxjis in this sorted list. I start¬ 
ed with the player at the lop of die list, and 
walked down the list, picking the first avail¬ 
able partner, providing they hadn’t played 
already. 'Then Id pick the player with the 
next-highest score (if still available) and 
find him a partner, and so on. Since the list 
is sorted, picking dose players from ihls list 
gives pairs with similar scores. 


/* schedule a pair 'pair.no'. and then the others */ 
int schedule_pair(const int pair_no. const int i_start) 

c 

if{ pair_no >= N_players/2 ) return TRUE; 

for(i=i_start; i<=N_ players; 1++) 
for(j=i+l: j<-NLplayers; j++) { 

int ti = Sorted_indices[i] * tj = Sorted_indicesfj]; 
if( allolti] =“= 0 && alio[t j] — 0 && Has_played[ti] [tj] = 0 ) C 
/+ Try pairing ti and tj */ 
alla[ti] - tj ; allo[tj] “ ti: 
if(schedule.pair(pair_no+l„i+1)) 
return TRUE: /* It worked I */ 
else 

alloEti] - alloftjj - 0; /* It didn't work. */ 

) 

3 

return FALSE: /* No valid pairing was found ♦/ 


Example 1; cW//sdieduJe_puiKO. 1 i to schedule the entire tournament. 


Player 

Round 1 
Played Score 

Round 2 
Played Score 

Round 3 
Played Score 

Total 

Score 

1 

2 

2 

5 

1 

7 

2 

5 

2 

1 

0 

6 

1 

3 

0 

1 

3 

4 

0.5 

7 

0 

2 

2 

2.5 

4 

3 

1.5 

8 

0.5 

6 

2 

4 

5 

6 

T5 

1 

1 

8 

2 

4.5 

6 

5 

0.5 

2 

1 

4 

0 

1.5 

7 

8 

1 

3 

2 

1 

0 

3 

8 

7 

1 

4 

1.5 

5 

0 

2.5 


Table 1: Three rounds of a sample tournament. 
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This greedy strategy of scheduling by 
adding pairs of players with the closest 
score may not necessarily lead to the low¬ 
est overall cost. For example, after pick¬ 
ing all but one pair, you have no choice 
for the final pair. It may happen diaL their 
scores are so different that the total cost 
is enormous. Worse, this last pair may have 
already played; Then the entire schedule 
crumbles. If this is the case, you can hack 
off and try changing the arrangement for 
the next-to-last pair, hoping that the last 
pair would be suitable tliis time. Although 
building the complete schedule this way 
may not be optimal, it is close. 

Note that die list of players is sorted in 
descending order, and I start pairing from 
the top. Most of the backtracking and fid¬ 
dling is then done with Lire players near 
the bottom of the list. That is, even if the 
final solution may not be optimal as a 
whole, you err by mismatching losers rather 
than leaders. The possible inaccuracy pays 
off handsomely in terms of complexity; It 
takes only n*(n- 1)/2 operations to go 
through the entire list and arrange pairs. 
Backtracking adds to the complexity, and 
this could be significant; however, in real¬ 
ity, the convergence is fast. The memory 
requirements are bounded and small. 

Once the schedule is complete, I eval¬ 
uate its total cost (called measure in the 
code, available electronically; see “Avail¬ 
ability, " page 3). Then I backtrack once 
again, trying to find another complete 
schedule. 1 repeat tills process up to five 
times, and pick the schedule with the 
smallest cost. Although the algorithm is 
based on a greedy strategy , it still tries to 
find a global optimum, The whole idea is 
similar to that of approximate TSP algo¬ 
rithms, even though at the time I only had 
a very vague understanding of TSP 

Implementation 

This fast algorithm was used to schedule 
die tournament in real time. That is, after 
a round was finished, the results were en¬ 
tered into die computer. It had to come up 
w ith a schedule for the new round while 
the participants were taking a break. The 
cumulative tournament results (history) 
were kept in a matrix Has_played and a 
vector Scores, with obvious meaning. The 
code had provisions to save/restore this 
liistury in a file, a precaution against the 
event of a power surge during the tourna¬ 
ment (it happened a lew times), Note dial 
die players are numbered 1 through n (so 
index 0 has a special meaning). A sched¬ 
ule is represented by a vector alio: atloffi 
if not zero, tells who player i is to play 
with; zero alkiij means dial player i is avail¬ 
able for allocation. The first step of schedul¬ 
ing is sorting die list of players according 
to their scores in array Sorted^ indices, so 
that Scores[Sorted_indices[if} >- ScoresfSort- 


ed_indices[jf] for all />/. Hie rest of the al¬ 
gorithm can lie written as in Example I. 

Function iry_ailocaie() (also available 
electronically) follows this idea almost lit¬ 
erally. with die exception dial it is not re¬ 
cursive. The first version of the code was 
written in DEC Basic on the PDP-11, which 
doesn't support recursion. F.ven when I 
later rewrote the program in C, I stuck 
with the faster iterative approach, 

The only variables that define an ar¬ 
rangement of a pair are the indices / and j 
of the players in die sorted list. You can 
keep these indices for each arranged pair 
in special arrays, si and sf accessed through 
an index level This makes it easy to back 
off the arrang emen t to die previous lev- 
cl(s). The scheduling process is made of a 


series of actions; Pick up a suitable i, pick 
up/ arrange the next pair (that is. advance 
die level" ), or back off and try die next j ; 
after that, try the next i. Hie action to ex¬ 
ecute depends on the previous action and 
some tests (availability of players). This is 
exactly how a finite automaton runs. Hie 
scheduler function in die listing implements 
dils automaton literally. 

The C compiler 1 Initially used was pre- 
ANSI C. I have recently beautified the code, 
mainly adding mid. The code runs, and 
even the user interface for a VTIOO termi¬ 
nal works. The program had been used for 
several years and. 1 think, helped convince 
my professor that computers aren't all evil. 

DDJ 
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lint 


for C/C++ 

Version 7.0 

presents Bug # 514 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 


ft include <stdio ,h> 
tidefine PEP P BRONX 1 

tidefine MUSHROOMS 2 

tidefine ONIONS 4 

tidefine PEPPERS 8 

tidefine ANCHOVIES 0 x 10 
tidefine SAUSAGE 0x20 

double pizza( unsigned order ) 

< 

double cost = 5.00,' 

if( order fit (SAUSAGE 3 PEPPERONI) == 
printf { "meatless\n ,f ); 
while( order ) 

{ 

if( order k 1 ) cost += 1.00; 
order >>= l; 

> 

return cost; 

> 


0 ) 


This program to process pizza orders attempts to record whenever a meatless pizza is 
ordered. But it doe so 7 seem to be working. Why not? Call if you need a hint, or refer to 
our web page at http: / /www. gimpel. com. 


PC-linl for C/C++ will catch this and many 
other bugs, [t will analyze a mixed suite of C 
and C++ modules to uncover hags, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions k can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches. 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2. NT and Windows 95, 
This price is subject to increase. 

FlexeLint for C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems. VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing, 

Qtap®) Softwmr® 

32(17 Hoganh Lane, CoIlegeviTle, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

3U Day Money-back Guarantee. 

PA 6% suits m*,. PC-li m unit FltxeUm are trademarks of Gi mpel Software 
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Dundas Software 


1 800 4631492 

Sales: 416 239 7472 
Fax: 416 239 2183 

EMail: sales@dundas.com 
WWW: www.dundas.com 


Ultimate Grid was designed from die ground up as a solid, professional tool to satisfy vour 
development needs. Based on powerful MFC classes. Ultimate Grid can be easily used as a 
CWnd, CView, CDialog, dialog resource, or a pop up! 

Ultimate Grid includes all the features you expect, and an extensive list of powerful new 
Features you can depend on. It connects easily to standard data sources such as DAO, 
ODBC, SQL, CodeBase, and c-tree plus. And, you can very easily connect to proprietary or 
other 3rd party databases, or use the built-in memory manager for pre-loading 

The professional edition includes full source code and allows you to develop custom data 
sources and new cell types, gives you enhanced debugging capability and greater 
development flexibility* 

Ultimate Grid compiles tight into your app; no ActiveX control or DLL to include! I l's 100% 
Royalty-free, just like all Dundas products* and includes a 30 day money-back guarantee. 

Call today, or visit our WWW site and find out for yourself why developers the world over are 
flocking to Ultimate Grid and making it the cornerstone of their development projects* 

Entry-Level $149.00 

Professional (w/ full source code) $349.00 

Generic C++ and ActiveX versions are also available. Call or visit our Web site for full details* 


Ultimate TCP/IP " 

Internet/Intranet Client and Server Development Kit 


* 30 day money-back satisfaction guarantee. 

* Visa, MasterCard, American Express, check, money order. 
■ We will deliver via Internet, CompuServe, mail or courier. 

* All prices in US doilars 


Dundas Software Ltd 
■ 500 - 4800 Dundas Street West, 
Etobicoke, Ontario, Canada, M9A 1B1 
* 670 - 240 Portage Rd, Lewiston, 

New York, USA, 14092 


nr FTP ^ CI ients a nd Se rve rs 

^ DNS * Custom Protocols 

* And More NT Services 

Whether you arc developing for the intranet or 
internet. Ultimate TCP/IP will be your trusted 
guide. Our well-constructed C++ classes allow you 
to solve both sides of the client/server equation. 

Entry-Level $199.00 

Professional (w / full source code) $499.00 


* POP3 
a'SMTP 
^ HTTP 


Ultimate TCP/IP allows you to design full-featured, 
powerful FTP, HTTP, DNS, Finger, SMTP/POP3 
applications, as well as proprietary protocols quickly 
and easily! Modify our sample server and client code 
to get exactly what you want instantly! Easily create 
multi-threaded Internet server applications that run 
as true Windows NT services. 


Ultima te Grid " 

100% MFC Object Oriented Design 

The Premier Grid control for MFC/C++ development, Ultimate Grid provides an 
outstanding 100% MFC object oriented design* Unparalleled power. Unparalleled features. 
Ultimate performance. 

Solid. Powerful. Professional. 
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Applying 

CSplitterWnd Internals 

George Shepherd and Scot Wingo 



I n our December 1996 column, we took 
a look at die internal structures of die 
popular CSplUterWnd class. This month, 
we'll show how you can apply knowl¬ 
edge of die CSplitterWnd internals to solve 
a CSplitterWnd problem that MFC pro¬ 
grammers ffequendy encounter. 

When using static or dynamic CSplitter¬ 
Wnd s in applications, you may want to 
change the splitter position programmat¬ 
ically. CSplitterWnd prov ides one undoc¬ 
umented solution that is easy lo use— 
simply add a menu/toolbar item that has 
1 D_W1 NDOW_5PUT as the identifier. 
When a user selects this menu/toolbar 
item, it will place the splitter into a mode 
where the user has to change the posi¬ 
tion of the splitter bar. The mouse cursor 
moves to the splitter bar t and the splitter 
bar is also put into tracking mode: The 
user can choose its position by moving 
die mouse and clicking to lock in the new 
position. Let's see hew this seemingly mag¬ 
ical feature works. 

ID_W1 NDOW SPLIT is a global MFC 
resource ID defined in AFXRES.H. The 
resource ID is used in VIFWCORE.CPP; 
see Example 1. QnUpdateSplitCmd( ) di s- 
ables the menu/toolbar item if the parent 
of the view is not a splitter window. The 
real work is done by CView:: On Split- 
Cmd( ). Listing One (listings begin on 
page 114) is die pseudocode for this mem¬ 
ber function. 

OnSplitCmdf) first verifies that die par¬ 
ent of the view handling the command 
is a CSplitterWnd by calling GelParent- 
Splitterf). If die view is inside a CSplUter¬ 
Wnd, it then ASSERTs that the splitter 
bar is not already in tracking mode, 
which should be impossible since the 


Scot is a cofounder of Stingray Software, 
He can be contacted at ScotWi@aol.com. 
George is a senior computer scientist with 
DevelopMentor and can be contacted at 
70023 . 1000@co mpuseme. com . 7 hey a re 
the coauthors of MEC Internals (Addison- 
Wesley, 1996). 


menu/toofbar item should be disabled by 
O nUpdateSplitCmdf ). MFC has many 
such ASSERTs that check the validity of 
states that should be True. This catches 
die problem of a user mistakenly chang¬ 
ing the behavior of OnUpdateSpHtCmdh) 
to allow the splitter bar to enter tracking 
mode twice. Once everything is validated, 

OnSplitCmdf) calls CSplitterWnd:: Do - 
KeyboardSpliK h Listing Two is the 
pseudocode for this member function. 

First, DoKeyboardSplit() does some 
if/else checking to fmd out which part 
of the CSplitterWnd needs to be ^acti¬ 
vated." For example, if there are two 
splits open. DoKeyhoardSplitf ) will need 
to move both bars, so it sets die value of 
hi to splitter!ntersection 1 Once the val¬ 
ue of hi is determined, DoKeyboardSplitf) 
calls StartTmckingC) —‘the same func¬ 
tion that is called when Lhe user presses 
the mouse button to “grab" a splitter bar. 
Finally, after calling StarfTrackingO, 
DoKeyhoardSplitf) makes some calcula¬ 
tions and then programmatically moves 
die mouse cursor over the splitter bar (or 
intersection) being manipulated by call¬ 
ing SetCu rsorPosi 1 


While the IDJ&dNDOWJSPLIT trick is 
helpful and easy to use, there are com¬ 
mon CSplitterWnd situations it does not 
address. 

No^ So Static CSplitterWnd 

Many of today 's applications have a Micro¬ 
soft Explorer look-and-feel with a verti¬ 
cal static splitter that separates a tree view 
on the left, and list view on the right. The 
problem with using CSplitterWnd for this 
functionality is that in static mode you 
cannot change the orientation of the split¬ 
ter bar. For example, what if you w ant to 
provide users with the ability to switch 
from a vertical presentation to a horizontal 
presentation? 

In our previous column, we showed 
that CSplitterWnd has key data members 
that maintain the row/column information 
for the class- see Table 1. We T ll need to 
manipulate these members to implement 
die static-bar flipping functionality. Since 
diese CSplitterWnd data members are all 
protected, the first step is to create a 
CSplitterWnd derivative so that you can 
freely access the data members and en¬ 
capsulate your CSplitterWnd enhancement 


0K_COMMAND.EX(ID.WINDOW.SPLIT, OnSplitCmd) 

ON.UPDATE.COMMAND.UI (ID.WINDOW. SPLIT. 

OnUpd at e S piit Cmd) 

Example l: Resource ID is used in VJEWGQRE.GPP* 

Data Member 

Description 

m_nRows/m_n 

Number of rows and columns currently being displayed 
in the CSplitterWnd. 

m_nMaxRows/ 
m nMaxCois 

Maximum number of rows/columns as specified in the 
call to CreateQ or CreateStaticQ 

mjDCoUnfo 

Array of CRowtnfo with one element for each column in 
the CSplitterWnd , This value is fixed in static splitter 
windows and varies in dynamic splitter windows 

m_p Row Info 

Array of CRowColInfo with one element for each row in 
the CSplitterWnd. This value is fixed in static splitter 
windows and varies in dynamic splitter windows. 


Table 1: CSplitterWnd data members . 
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in a stand-alone class. The enhanced 
CSplitterWnd is called " CDohhsSplUter, ” 
and its declaration is presented in Lis Ling 
Three. From Listing Three you can see 
that a couple of dam members have been 
added to CDohhsSplitter to help with the 
implementation of the FlipSplitf ) function. 
Table 2 lists these data members. 

Listing Four is die implementation of die 
CDohbsSplitter class. The main functional¬ 
ity provided by the class comes from the 
FlipSplitf ) member function* This member 
function determines whether the splitter- 
window is currently split horizontally or 
vertically, then calls either SplitVerticaUy() 
or Split Ho rizo n lcdly( ) to “flip" die split. 
'Hie logic for detecting whether the cur¬ 
rent split is horizontal or vertical is based 


on die number of rows. For example, if 
the number of rows is greater than the 
number of columns, then the split is hor¬ 
izontal. If the number of columns is greater 
than the number of rows, then diere is a 
vertical spill. 

The SpUtHorizontally( )/SplitVerticallyi) 
functions actually perform the manipula¬ 
tions of the split. They do this by pro¬ 
grammatically swapping the numbers of 
rows ( m_ nRo tvs/ m_ nMaxRows) a nd 
columns C m_nCols/ m_nMaxCoLs). After 
sw apping the values of these data mem¬ 
bers, die row and column information ar¬ 
rays are also swapped ( m_pCollnfo and 
m_pRowIufo). Next, the ID given to each 
pane is swapped so that there are no fo¬ 
cus problems using the SetDtgCtrllDf) 


Data Member 

Description 

m bPanesSwapped 

Boolean that indicates if you are in the original state (False) 
or in a "flipped* state (True) so that you can change back 
and forth easify. 

m_nSp!itRatio 

When flipping the split from one position to another, be 
sure that you keep the ratio of the two panes exactly the 
same. This data member is used to store the ratio. 

m^nSplitResolution 

Since you don't need to be TOO percent exact about the 
ratio of the panes, use this multiplier (500 works well) to 
convert the ratio into a large integer to avoid floating-point 
arithmetic. 

Table 2: CDohbsSplitter data members * 


APT. Finally, whenever you programmat¬ 
ically change a splitter window, you must 
cal! RecalcLayouU) to cause the splitter 
window to update* 

Notice also that Spl it Horizon! ally/) 
and Split Vertically/) make a call to the 
UpdatePanes() member function. This 
member updates the m_pCollnfo and 
m^pRowInfo size information arrays w ith 
new r data based on the new split This 
data is calculated using die previous split 
ratios and sizes of the panes. 

Conclusion 

By applying some of our undocumented 
CSplitterWnd knowledge, you have added 
new functionality to die CSplitterWnd and 
given end users lhe flexibility to change 
the appearance of a program that uses a 
static splitter. You can take this example 
and extend it to swap panes, or work in 
a CDmlog, For a real challenge , you might 
even try to make a dynamic CSplitterWnd 
that can have more than tw r o rows and 
columns. A sample application that fur¬ 
ther illustrates how this additional func¬ 
tionality can he implemented is available 
electronically fsee "Availability,” page 3). 

DDJ 

(Listings begin on page 114.) 




multi** o . 


Lost in a jungle of languages? Crushed in the coils of immense binary files? 
Unable to escape the voracious jaws of impending deadlines? Are your 
•A development projects eating you alive ? 

w ^ C)K t it's probably not quite that bad. Still, you are confronted daily with the challenge | 
of managing large numbers of source files, using multiple languages & compilers, 
integrating with different vendors 1 tools, and coordinating with oilier developers’ 
work. The Iasi thing you need is to be burdened with inflexible, under-powered 
editing tools. You need an editor designed to adapt to your own individual work 
style, that supports the languages you work with, one that will SAVE YOU TIME! 
Multi-Edit is your answer. 


For more than eight years, Multi-Edit has increased programming productivity world wide. 
With extensive support for C/C++, Delphi, Java, Fortran, COBOL, HTML, PERL (just to name a Few), and 
features like code templates, hex-editing, file compare, VCS integration, multi-file 
search and replace, and more, Multi-Edit will do the same for you! 

"Unbelievable, the best 

editor I've ever used .., PJ 
■ - ftess Mason; .Shrilly Systems, Inc. 

Get an in-depth look at what Multi-Edit can do for you. 
Visit our web site and check out our fully functional demo! 





www. ameyber. com 
1 - 800 - 899-0100 


Suggested 
Retail Price 
$199 


Multi-Edit is a. tmdemark of American Cybernetics, toe. Otter products are trademarks ot 1 dm respective publishers. Delphi js a trademark ot Borland. Developer tested 
only American Cybernetics stands behind ail of its products with a 30 day Money Back Guarantee. No animals were eaten by other animats during the making ot this ad. 



1630 West University Dr. Ste. 11 2 
Tempe, AZ. 852B1 
Voice: (602) 963-1945 
Fax: (602) 966-1654 
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C PROGRAMMING 


Listing One 

// --- Bidiin „h 

Bifndef MEDIINJJ 
ftdefine KIDIIH_H 

R include <nrnsystein, h > 

class Midiin [ 
void* m.pFurtc; 

HMIDIIW bHidilnt 
short int ttuaDevices; 
short int cur i: Device; 
public: 

HidilnQ ; 

~Kidiln'0; 

void RegxBterKIDrFunGtiionfvoid* pFune) 
{ ■_pFune = pFunc; ] 
void DeviceList(CListBoj 1 * dliflt) ; 

BOOL CJxangeDevice (short int device); 

] : 

Bendif 


Listing Two 

//-iaidiin,cpp 

ft include H s-cdafa:.h’ f 
ft include M midiin.h n 

Midiln:; MidiluO 

{ 

nupFunc = 0; 
hWidiln = 0; 
currDevice « -lj 

numDevic es = ran diInGetNumDevs(); 

} 

mdilm:~WidiInO 

( 

if ChMidiln 1^ ®) E 
midilnStop(hHidiln); 
midilnClose(hMidiln); 

) 

1 

yoid Midiln: :DeviceList [CLlstBoit* dllet) 

[ 

1 = 0 ): 

rtlDilHCAFS icapa: 

for (short int i = 0; i < numDeviqes; i++) [ 

midilnGetbevCapS £i, Biceps, sizecf (leaps)); 
dliflt - >AddSt ting. £ leaps, s z Roams) ; 

1 

3 

BOOL Midiln; :ChangeJ>e vice (short int device) 

£ 

ASSERT(device t numDevices); 

ASSERT(ra.pFunc 1= 0): 
if (device 1= currDevics) E 
if (hMidiln) [ 

iitfdilnStopE hMidiln): 
midilnCIose(hMidiln)[ 
hMidiln = 0; 

3 

KMIDIIH bln; 

if (midiliiGpen (thin, device. (DWORD) o.pFunc^.CALLBACE.RUKCTION) 1= 0) t 
currOevite - -i; 
return FALSE; 

) 

hMidiln = hln; 
midilnStart(hMidiln): 
curtflevice — device: 

) 

return TRUE; 


Listing Three 

// aidiout-h 

ftifndef MIDIQUT_H 
ftdefine MIDIOUT.H 

ftiaclude <ffimsy£tem.h> 

class MidiQut E 

HKIDIOUT hMidiOut; 
short int isuaDevices; 
short int currDevice; 
public: 

MidiOut 0: 

-MidiOut0; 

void DsvireList(CListBox* didst); 
void SendEvent(DWOR£l dwEvettt); 
void StartMessageQ ; 
void EimingKessageO; 
void 5topMessage(); 

BOOL ChangsDevice(short int device); 
void CloaeDeviceO t 


); 

inline void MidiOut::SendEvant(DWORD dwEvent) 
[ 

if (hMidiOut != 0) 

midIOutShortMsg(hMidiOut, dlvBvent) : 

3 

ftendif 


Listing Four 

//-middrmt,cpp 

t include “stdafx.h 11 
If include “midiout. b " 

MidiOutMidiOut() 

E 

hMidiOut = 0; 

// - test for MIDI output devices 

mimDavicee = midiOutOetNuniDsvs{) ; 
currbevico = -1; 

] 

HidiOut:;~Mid IOut () 

{ 

ClDseBeviceE); 

3 

void MidlOut:iGIoaeOeviceC) 
f 

if (hMidiOut 1= 0) t 

// — close the device 
mid iOutClose (hMidiOut); 
hMidiOut = 0: 

) 

) 

BOOL MidiQut::GhangeDsvies(ahort int device) 

c 

ASSERT (device < mmDeviceB + 1); 
if (device l« currDevice) ( 

CloseDeviceE); 

// — open the new device 
HKIDIOUT hOut; 

if (nidiOutUpen(ShOut, device, 0, 0L, 0L) 1 = 0) [ 
currPevice =? -l: 
return FALSE: 

3 

currDevite - device; 
hMidiOut = hOut; 

) 

return TRUE; 

1 

void MidiQut::StartHessage() 

C 

if (hMidiOut 1= 0) [ 

DWORD Tpmsg = 0rfe; 

midiOutShortMsg(HMidiOut. mms g): 

i 

3 

void MidiQut:;T±mingMeasage() 

L 

if (hMidiOut |= 0) ( 

DWORD mmsg - 0xf8: 

midiOut She rtMsg(hMidiOu t > wnsg); 

1 

] 

void MidiOut;;StcpMeseage() 

E 

if (hMidiOut i= 0) { 

DWORD mniEg = Oxfc; 
midiQutSbortMagEhMidiOut, mmag)i 

3 

3 

void MidiOut:: Devi c oLi st [CListBoji* d 1 ist) 

E 

ASSERT(didst ■= 0): 

MIBIOUTGAPS neaps: 

for (short int i = 0: i i nunDevicea: i+ + ) C 
EidiOutGctDevCspa(if fcocaps, siseof (oc-spe)) : 
dliat->AddString(neaps„sEPnane): 

3 


JAVA Q&A 


Listing One 

/* Copyright (c) Digital Focus, 1996, L997. 

* This rode may be used for non-commercial purposes, 

* Digital Foeno gives no warrantee or guarantee, 

*/ 

import java,applet,*: 
import ]avfl-awt,*T 
import java-io,*; 
import java,Util.+; 
import java.net,*: 

(continued on page 114) 
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(continued from page 113) 

/** Query Tool, */ 
public class Client extends Applet 
[ 

Text Area q He ryWindow = new TextArea(3, 40)I 
Button ga = new Button("Execute"); 

QuetySvealmpl querySvts; 

/** Initialize the applet. 
public void initt) 

[ 

add(queryWindov); 
add(go): 

// Instantiate query Serviced 
try 

t 

querySves - new Q.uerySvcaInipl(getParameter< ,l protoeol 1 '), 
get Parameter (’’host"). getParametor (''dsn") . getParameter ("uid"), 
getParamater (’'pwd")): 

J 

catch (java.sql.SQLException ex) 

i 

ex,priEt5tackTrsce{) ; 
ehow&tatu&iex-getHeasageQ) ; 
return; 

J 

3 

/** Handle the button preaa event. */ 
public boolean handleEvent(Event g) 

t 

if [(e.target = go) (e.ld ^ Event .ACTIOTLEVENT)) 

t 

java.aql.RegultSet r = null: 

String html = null; 

UHL url - null; 

try 

c 

r = querySvc e,aelee t(queryWindsw.ga tText 0): 
html - queryS vch, talTTML(r); 

System. out. print In (html) 

url ■ new URL("javascript: p " + html + """): 

getAppletContextO . ahowDocument(url, "results.-windou 11 ); 

I 

catch (Exception ex) 

[ 

ex, printStsckTrace(); 
ehowStatus{ex-getKessage0)r 
return true; 

) 


return true; 

J 

else return supac.handleEvent(a); 
] 


UNDOCUMENTED CORNER 


listing One 

BOOL CView:;OnSplitCmd(HINT) 

t 

CSplitterWnd* pSplitter = GetFacentSplitter(this. FALSE); 
if (pSplitter = NULL] 
return FALSE; 

AS SUET{Ip S piitter->IsTracking ()) i 
pSplitter->DaEeybaardSpIit(); 
return, TRUE; 

1 


Listing Two 

BOOL CSplitterWnd:[DaKeyboardspiit() 

C 

int ht; 

if fm_nRows > I fci ra_nCols > 1) 

ht. = splitterlntereaction!; // split existing row+col 


else if {m_nHotfs > l) 
hi = vEplitterBarli 
else if (m.uCals > 1) 
ht = hSplitterBarli 
else if (■.uMfliRowiS > 1 Sk 
ht = bothSplitterBc.il; 
else if (ti.tiMaxRowfl > 1) 
ht = vSplitterBox; 
else if (m nMaxCola > l) 
ht = hSplitterBox: 

else 

return FALSE; 

// start tracking 
EtartTracking(ht): 

CFect rect; 


// split existing row 

// split existing cal 
L_nMaatCols > 1) 

// we can split both 

// we can split rows 

// wc can split columns 

// can't split 


THE POWER OF TRUE 0-0 TECHNOLOGY 

SOFTWARE ENGINEERING FOR WINDOWS 


File JitJIt Vini 
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Mellor, Coad-Yourdon & the 
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any language 
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• Unique scripting language for custom 
code generation & reporting 

•INCREDIBLY AFFORDABLE! 
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net.left “ m^MctTrackar.Width0 / 2; 
rect.top = b_ rectTrackec.HeightU / 2: 
if (m_ptTrackOffeet.y 1=0) 

rect.top = a_rectTracker.top; 
if (m_ptTrackOffeet,n |= 0) 

rect.left = ni-bTracking^ 7 m_rectTrackeir2-Xeft ;m_rectTi:acket.le£t: 
rect ,0ffeetReot f-uLpfTtacIcDffast.i. -H.ptfrackOffRet. j); 
ClientToScreent&rect}; 

S etCureg r Fob( rec t.1Eft, c e gt,top}: 

return TRUE; 

3 


Listing Three 

Glass COubbeSplitter : public CSplitteiWnd 
C 

// Construction 
public: 

CDobhsSplitter()j 

// Attributes 
public: 

BOOL nLbPanesSwapped: 
int m_nSplitRatio; 
int m_nSplitResolution; 

// Operations 
public: 

void SetSplitRatio* int nRatio 3: 

BOOL EsSpIitHorizontally() consL; 

BOOL IsSpIitVertically f) const f return IlsSplitfloriaontallyOj 3 
BOOL AraPanesSwapped{) const { return m_bPanesSwappod; 3 
protected; 

BOOL UpdatesplitRatlo0; 

BOOL BpdateFanenf int ex, int oy }; 

BOOL tfpdatePauesO; 
public: 

void FlipSplitO ; //DDJ 
void SplitVerticallyO : 
void SplitHoricontallyO: 

// Implementation 
public: 

virtual ^CDobbsSplitterO ; 
protected; // Generated message map functions 

flfx.msg void OnSise CUlfJT nType , int ex h int cy ); 
DRCLARE_ME$SA&E_MAF () 

); 


TIFF JPE6 6IF PCX OCX BMP IMG WMF WP6 IGA EPSF 


“As a programmer, 1 especially 
appreciate how easy if is to use 
tftij&geMan ." 

Mi chid Taukus 
Data Based Advisor 




* l DatA Techniques is willing 
to go the extra mile to main* 
lain customer satifaction,” 

Dante I Men dyke 




"I have all of the available 
image processing pack' 
ages and without ques¬ 
tion Hike yours the 

best” | 

Dr. Oscar Linares 


"Of all the libraries we bought 
inclusion in our product, yours 
only company we would ever purchase 
code from in the future” 

Janies Brats a tv is 
MlC TOC LlltS 


ak Mcm 


*We have been impressed with the 
architecture and hope to use this strat¬ 
egy in our own application n 

Tim McCarthy 
Pilot Software 


l£ [ have found Data Techniques 
to be very receptive to my 

needs as a customer, and they 
have been appreciative of the 
suggestions for enhance men is 
and new features* 

Kerry Lancaster 


Listing Four 

CDobbgSplitter::CBobbflSplitter *) 

( 

//intialize esrtendsd state. 

m_ii5pl it Ratio = ~1; 
m-bFanesSvapped = FALSE: 
nSplitResolutioTv = 1: 

} 

BEGIN_ME3SAGE_HAP EUDobbaSplitter, CSplittertfnd) 

0N_WM_SIZE(3 

END ..MRS SAGE.MAP *) 

void CDobbeSplitter:jSetSpIitRatioE int nRatio ) 
t 

nunSplitRatio * nRatio; 

3 

BOOL CDobbsSplitter:ileSplitBorixontallyO const 
[ 

ASSERT(t hluBovb >1 ) 1= ( ijlhCoIs > 1)3; 

ASSERT ( Tnax( m.nflgwa. m.TvCole } = l ); 
return ( m_nGoU > 1 ) t 

3 

void CDobbflSplitteri:SpiitHorizdntally() 

c 

if* IflSplitHorizontflllyO) 
return: 

ASSERT{ m.uCols. = 1 ): 

ASSERT* m_nRowa = 2 }: 

CVfnd* pFane = GetPlglteiTiE IdFromRovColE 1, 0 }3; 

ASSERT* pPnne 3: 

// swap the B/V information 
IrunMaxColn = ra_tvCalB = 2; 

Tn.nMaxRgws = m_nRovB = 1; 

CRowCalljifo* pTinp - m_pCollnFg: 

UL.pColInfa - m_pRowInfo; 
m..pRowInfQ ■ pTiup; 

// change the last pane's ID reference 
pFane->5etD 1 gGtr 1 ID( IdFtomRowCoH 0, 1 J); 

ASSERTE GetFane f 0, i 1->GetSafeHwnd0 = pFane->GetSafeHwnd*) ): 
iff UpdateFanesO) 

RecalcLayoutO ; 

] 

void CDobbsSplitter;:SplitV^cticallyQ 

t 

iff iBSplitVerticflllyOJ 
return: 

ASSERT* nunCols » 2 ); 

ASSERT* nunRows = 1 ) : 

CWnd* pFant = GetDlgltemEldFroiiRowColE 0, 1 )}; 

(continued on page 116) 


/mageMam—Trusted By More Of The 
Companies You Trust 


ImageMan is used in more off-the-shelf applications than any other imag¬ 
ing library available, including applications like: 


LotusAppmach 

Corel Draw 

Data blase Impress 

Zykth ZyIndex 

Miles1 111 jes, / lie . f Kidusa ) 


My Advanced label Designer 
M j > Aih m 11 ved Mailii ig L 1st 
Avery LethelPro 
Gt iptif SQL Wi t ult m s 
More... 


These companies didn't choose ImageMan because of slick advertisements 
or meaningless guarantees. They chose ImageMan because it meets their 
real-world image processing needs. They chose ImageMan because it's the 
fastest, easiest to use, and most comprehensive solution they could find. 

And they chose ImageMan because ImageMan is clearly a technically supe- 
rior product. Take the time to compare ImageMan n demo with those of 
our competitors, compare the APIs, and you’ll come to the same conclusion 
that some of the best programmers in the industry have already reached: 
ImageMan is the only choke for creating truly world-class products. That’s 
why ImageMan is a Visual Bask Programmer's journal Readers’ 

Choice award recipient, and that’s why ImageMan users are so devoted. 

ImageMan has always been offered with an unconditional 90-day money- 
back guarantee (yes, even the 32-bit versions). We can offer (his extraordi¬ 
nary guarantee because of our extremely high level of confidence in our 
product. Can our competitors say the same? 

ImageMan is available royalty-free in DLL or VBX/OCX format for 
Windows 3,1, Win32s, and Windows NT. Source code available 


‘"The best thing about the ImageMan 
control is speed.” 

Steve Okonski 
Visual Basic Programmers Journal 


U 1 like the interface to your 
product. It’s one of (he simplest 
and easiest API’s I have used for 
imaging" 

Kendall Smiib 
Doctimenttiffi (Xerox) 



800-955-8015 


140 Bowditch St, fi b 
Burnsville, NC 

(7U4) BB24111 
\ ax: (7frS) AR2-0025 
BBS; (704) 6&243S6 
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CIRCLE NO. 80 ON READER SERVICE CARD 







(conti n ued from page 115) 

ASSERT ( jjPane ); 

// ewap the H/V information 
m.uHaxColB = n_nCols = 1; 
m nHaxRows = m.nRovs = 2 ; 

CRowCoilnfo* pTmp = m_p€olInfo; 
m_pColInfo = a.pRauInf^: 
m_pEovEnfo = pTmp: 

// change laat pane's ID reference (no need to change ID fot first one} 
pPane->SelDlgCtrIID[ IdFrolflROMCol( 1, 0 3}i 

ASSERT( GetPane ( 1, 0 ) M&atSafellwndO *™ pP&M->GatSafeHwidO J i 


iff UpdatePanesO) 

RecalcLayoutf); 

) 

void CDobbeSplitter: ;FlipSplitO 

[ 

i£{ teSplitHorizontally()) 

SplitVertically[)j 

else 

£ 

ASSERT( IsSplitVerticallyf)}; 

SplitHorizontallyO: 

3 

3 

int CDobbsSplittac::UpdateSplitRatio f 1 

[ 

CRovColInfo* pPanea: 

int cxSplittec: 

iff IsS piitEo rfzant ally f)) 

C 

pPanaa - B.pColInfo; 
czSplitter > to cxfiplittar; 

} 

else 

£ 

pPanea - m-pRowlnfos 
czSplitter = n_cySplittat; 

1 

TRACE £ "CDobbsSp litter ; : UpdateSplitRatI d 1 l3'i. ZMiW, 
pPanea [0] .nCiirSize. pftatieatl] .nCurSize}: 
if(C pFaneef©]„nCutSize E= -1 ) Si 

( ppaneaffij .nCyrSize + pPaneaU] .tiClirSize ! = 0 )) 

E 

m. fiSplitRatio = nSpIitRc a elution * pPaneu |0] .nCurSiz* / 

( pRatiejelffl] t nCurSize + pPanea [lj .nCurSize + czSplitter J: 

3 

TRACE£ l, Di.nSplitRatio« / i\n l, r ra.nSplitRatio ); 
return n nSplitRatio; 


BOOL CDobbeSplitter:lUpdateFanesf) 

{ 

CEeut rcClient: 

GetClientRect { rcClient ): 
return { !rcClient*IaRectEtnpty{3 &i 

UpdatePaneflf rcClient.Width(), rtCllent.Height[))3; 

I 

BOOL CDobbaSplitter::UpdatePanea£ int ci, int cy ) 

C 

TRACE("UpdatePane b: cx=/l, cy=7£\n" , cz. cy ); 

CRo^ColTnfo-+ pFanes; 
int cz: 

iff teSplitHgrisontally()) 

£ 

pPanea - m_pColIlif □: 
cz = m 

3 

elae 

t 

pfanes = in.pRowInfa: 
cz = cy; 

1 

BOOL faRea = Update B piitftfltin {}; 
iff m.nSplitRatio >= 0- 3 
[ 

ASSERT f fULONG) m.nSplitRatio Mi/ 

tiSp litReso lu Lion {ULONG} IHT..MAX ); 

pFanes[0]. n IdealSize = 

int{ (UL0MG3 m._nSplitRatio + cz / nSplitResolution }; 

3 

return bRes; 

} 

void CDobbeSplifter: :OnSize( UTNT nTypa. int cjt. int cy ) 
i: 

TRACE ("CDebbaS pi itter: : On Size: c*:/i H ey:, r i\n' h . ra, cy Jj 
iff( nType 1= SIZE.MINIMIZED )&& £ cx > 0 )U< cy > 0 ) ] 
"Update Fanes( ck f cy j; 

CSplitterVnri::OnSizef nType, ex, cy }; 


DUJ 


Online Help 
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PROGRAMMER'S BOOKSHELF 


Into the Future 

Phil Mitchell 



T he prolific French novelist Balzac was 
once asked how lie was able lo write 
so many books. He replied, “1 never 
use labor-saving devices ” It’s unclear 
what 19th-century gadgets Balzac was 
avoiding, but apparently die sentiment is 
timeless: The biggest “labor-saving” de¬ 
vice that should never have been used, 
according to Thomas Landau er t is about 
$3 trillion worth of computers applied in 
business over the past two decades. This 
appalling conclusion sets the stage for his 
engaging and lucid book, The Trouble with 
Computers . 

Ttoe Trouble with Computers 

Fiscally speaking, the trouble with com¬ 
puters is that economists can't seem to 
show that they help the bottom Une. Of 
course, die re were the early, easy gains 
from number crunching; and there are cer¬ 
tain specialized applications, notably CAD, 
where computers have made the un¬ 
thinkable possible. Rut in terms of the ser¬ 
vice industries that increasingly dominate 
our economy, wdiere information tech¬ 
nology (IT) was supposed to trigger vast 
efficiencies for ordinary workers, there’s 
no sign of a productivity gain. To the con¬ 
trary, productivity growth in the era of 
minicomputer and desktop applications 
has notably and unsettlingly slowed. 
Landauer goes so Far as to argue that in¬ 
vestment in IT was a major cause of this 
downturn, because, in many cases, it was 
wasted money. Rut while causality is hard 
Lo prove (and Landauer is no economist), 
w hat’s liard to argue w ith is that the huge 
productivity gains forecast for computer¬ 
ization, gains on par with mechanization, 
simply haven’t materialized. 

Landauefs sedulous examination of the 
“productivity paradox prompts the ques¬ 
tion: What went wrong? He r s glad you 
asked. For despite the plodding econo¬ 
metrics of the early chapters, Landauer is 
a man with a tiirilling story to tell When 
he examines the reasons for IT’s failure— 
reasons that include the hidden costs of 


Phil president of NeoConek, can be con¬ 
tacted at phil_mitche!Mnmcortek.com. 


The Trouble 
„ with Computers: 

...V!.V.Vl- l Usefulness, 

■leu -.t: nua | Jsabillty, and 

Productivity 

Thomas K, Landauer 
MIT Press, 1996 
440 pp . 3 $ 15.60 
ISBN 0-262-62108-8 

1 The Future 
of Software 


Edited hy Derek Leehaeri 
MIT Press, 1996 
320 pp., $ 13,50 
ISBN 0-262-62109-6 



training and maintenance, the absence of 
standards and interoperability, and mis¬ 
management and misapplication of tech¬ 
nology— he finds the overriding, funda¬ 
mental flaw to be die failure of designers 
to create useful and usable software. But 
the thrilling part is that he’s sure this is a 
problem that can be fixed, and lie’s con¬ 
vinced that if it were fixed, the ensuing 
productivity gains would truly revolu¬ 
tionize society. 

Tills is not, however, a book of wishful 
thinking. Landauer headed up one of the 
h u man fac tors /user- i nterface re sea rch 
groups at Bell Labs in the '80s. He brings 
to the Lopic of usability the rigor of em¬ 
pirical psychology and die extensive ex¬ 
perience of an insider from one of the lew 
industries w r ith a major IT success story to 
tell It is a powerful combination. His cri¬ 
tique of usability, across a broad spectrum 
of applications, is relentless anti insightful 
The quirkiest example is his application 
of the concept of random reinforcement 
schedules to computer users. (It is well 
known in academic psychology that a pi¬ 
geon— or a person—who is rewarded 
for some behavior according to a regular 
and predictable scheme will behave logi¬ 
cally: If the rewards are frequent enough, 
die behavior is maintained: if they become 


too infrequent, the Ixdiavior stops. But if 
die reward schedule becomes random and 
infrequent, the result is obsessive behav¬ 
ior that does not extinguish. See online 
Help.) 

Landauer’s real mission, though, is to 
show us how to do better— how to create 
that useful and usable software to pro¬ 
duce the gains we’ve tieen looking for. In 
the final third of the book, he discusses a 
number of examples where usability 
design was done right. In particular, his 
detailed discussion of an electronic book 
project at Bellcore is fascinating. From 
these examples, and from numerous em¬ 
pirical studies, Landauer draws some re¬ 
markable conclusions. 

For instance, studies repeatedly show 
that computer users exhibit wide variability 
in efficiency, Among expert manual typ¬ 
ists, the worst performer might be about 
30 percent slower than the best; among 
expert word processor users, the differ¬ 
ence jumps to 400 percent! (This effect is 
notoriously present among programmers*) 

There are a number of ways that com¬ 
puters seem to magnify variability; bur the 
startling conclusion dial Landauer presents 
is that it is possible to design systems that 
eliminate much of this variability. Where¬ 
as a poor interface tends to separate the 
good users from the bad, a well-designed 
interface can bring most people up to a 
high level of performance. Contrary to cur¬ 
rent practice, Landauer proposes that sys¬ 
tems should be designed not to maximize 
users’ choice and flexibility, (users 1 intu¬ 
itions being as bad as programmers’), but 
to offer them die clear-cut best way. 

There’s nothing mysterious about de¬ 
sign for usability. It centers around (sur¬ 
prise!) testing applications with real users 
in an iterative design process. But there 
are some useful facts to know. For ex¬ 
ample, It doesn’t take a large and expen¬ 
sive study to do rigorous usability testing. 
The average interface has around 40 de¬ 
fects in need of repair; having two naive 
users evaluate it will find about half die 
flaws, and six evaluations will typically 
find about 90 percent. Additionally, soft¬ 
ware that doesn’t go through careful 
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API, RPC and Named 
Pipes. 

Ralph Davis 

«832 pages 
■ $44 95 w.'disk 
*0-201-48930-9 


MFC INTERNALS 

George Shepherd and Scot Wtngo 

560 pages * $39.95 w/disk • 0-201-40721-3 


MULTITHREADING 
APPLICATIONS IN WIN32 

Jim Beveridge and Robert Wiener 

400 pages * S39.95 w/CD-ROM • 0-201 -44234-5 


www.aw. com/rievpress 
//orderJnfo/gold.html 

AVAILABLE WHEREVER COMPUTER BOOK- 
ARE JOLD OR BY CALLING 
1-800-822-6*39 or 617-944-3700 XS190 
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usability testing is pretty much guaranteed 
to lower user productivity. Designers who 
hope to do otherwise would do well to 
read this lx>ok, 

Tifie Fufune of Software 

Landauer's book left me wondering what 
the big software manufacturers would 
have to say about these matters. Conve¬ 
niently, in The Future of Software, Derek 
Leebaert invited representatives of IBM, 
Microsoft, Lotus, Novell, Intel, and DEC, 
as well as assorted industry insiders, to 
give their views on the usefulness of 
software, present and 
future. 

The official agenda 
of the book Is the 
“software problem,” 
the fact that our re¬ 
markable progress in 
hardware seems to 
outstrip our ability to 
design remarkable 
(read; intelligent) soil- 
wane. But beneath this 
problem statement Is 
the productivity' para- 
dox, as several con¬ 
tributors make explic¬ 
it. Microsoft's director 
of enterprise comput¬ 
ing feels our vast in¬ 
vestment in personal 
computers has not delivered value to in¬ 
dividuals and organizations, (But tear not, 
ii will soon.) 

Asking these companies to describe 
the future of software is a bit like asking 
the National Cheese Council to describe 
die hiture of hors d'oeuvres. The results 
are pretty unsurprising, with convergent 
views on the ascendance of networking, 
open standards, and business reengi¬ 
neering tin llie basis of enhanced infor¬ 
mation flow. Still, ids intriguing to listen 
to what the big guys want you to think 
they're thinking. 

For instance, Microsoft lumps main¬ 
frames and PCs together as relics of liier- 
archical, assembly-line organizational 
thinking. Ids die client/server model, sup¬ 
porting distributed databases and seam¬ 
lessly integrated application suites, dial 
will enable businesses to restructure 
around processes: There will be no more 
isolated order-entry cJerks—a salesperson 
will shepherd the entire process from 
order to fulfillment, 

Lotus goes a step further, suggesting 
that the current suite of computing is posi¬ 
tively medieval, and dial workgroup com¬ 
puting will usher in a humanistic renais¬ 
sance. Die writers take some hard shots 
at the current state of usability, averring 
that “...most of die problems with com¬ 
puters [are] diat computer people [talk] 


too much to their computers and not to 
odier people/ Rather than productivity 
enhancements for the individual work¬ 
er, “intelligent communications 1 * will em¬ 
power workers and revolutionize 
decision-making processes at all levels: 
Relationships with customers, suppliers, 
and business partners will become effi¬ 
cient, mutual, and collaborative. 

The contributions from Digital and 
Novell have a different emphasis: Bodi en¬ 
vision a future in which die end user (and 
who better?) is able to create his/her own 
software. Open standards and reusable 
components will put 
an end to the need for 
expert programmers to 
create novel applica¬ 
tions. Die interesting 
part of DECs piece 
describes two current 
efforts at standardiza¬ 
tion: a user-driven ef¬ 
fort in which the 
Japanese telecom gi¬ 
ant NTT demanded 
that its suppliers tran¬ 
sition from proprietary 
to open standards, 
;ind an industry-driven 
effort (the SPIRIT pro¬ 
ject), in which Ameri¬ 
can, European, and 
Japanese telecom and 
IT companies are collaborating on such 
standards, Novell, on the other hand, em¬ 
phasizes its Visual AppBuilder, in which 
software components will enable vendors 
or end users to design complex custom 
business applications in a single clay. 

Conclusion 

Die problem with these futurist manifestos 
is that each ends without ever addressing 
the software problem; these marvelous fu¬ 
tures assume a new level of software in¬ 
telligence without indicating how it will 
lie achieved. Somehow, networked com¬ 
puters are going to lead to natural- 
language translators, and open standards 
are going to make object components triv¬ 
ial to use— but no one explains how. Die 
one article that tries to Jill this gap is Gus¬ 
tave Essig's essay on natural-language pro- 
cessing and artificial intelligence, Esslg, a 
philosopher and computer telephony en¬ 
trepreneur, believes that new knowledge 
representations, based on functional insights 
from tlie neural and cognitive sciences, 
are about to make fully intelligent "natural- 
ware ” possible. Well see. In the mean¬ 
time, it's hard to take another round of big 
promises seriously. I’d settle for some 
decent usability testing. 


DDJ 


The trouble with 
computers is that 
economists can 7 
seem to show 
that they help 
the bottom line 
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Metrowerks f Code Warrior development 
system has been made available for Win¬ 
dows. The Windows-hosted compiler can 
generate executable code for Windows 
95/NT x86, MacOS 68K, and MacOS 
PowerPC. It supports C, C++, Object Pas¬ 
cal, and Java. The system is available in 
several different bundles, ranging from the 
professional Gold package ($399-00, in¬ 
cluding three updates over the next year) 
to packages targeted at beginning pro¬ 
grammers ($79 00) and students ($ 119,00), 
Developers who purchase the initial De¬ 
veloper’s Release will receive automatic 
updates to the final version when it be¬ 
comes available, 

Metrowerks Inc, 

2201 Donley Drive, Suite 310 
Austin, TX 78758 
800-377-5416 

http;//www,metrowerksxom/ 

Infrastructures for information has an¬ 
nounced a desktop edition of its Standard 
SGML Support System (S4), a real-time 
SGML language processor. Delivered as 
middleware, S4 can be embedded in ex¬ 
isting software such as word processors, 
composition tools, databases, and die like. 
The S4-Desktop API implementation in¬ 
cludes over 70 function calls to support 
SGML-tag searching and navigation, at¬ 
tribute searching and navigation, hyper¬ 
text navigation, and contact extraction. 
The S4-Desktop Developer’s Package also 
includes a number of sample applica¬ 
tions— such as a set of Word macros that 
allow the use of Microsoft Word as the 
composition engine—and sample code 
diat shows how to decompose SGML in¬ 
stances into infonnation components, store 
them in an SQL database, and reassemble 
them for export as valid SGML files. Also 
included is an Adolie Exchange Pfug-Tn 
that automates the process of redoing 
SGML hodinks and TOCs into PDF files. 

S4-Desktop is delivered as a set of DLLs 
in the Windows environment and as a set 
of shared libraries in the Macintosh and 
UNIX environments. It costs $1500,00 for 
the Developers License, plus $149,00 per 
seat run-time charge. Three versions— 


J6- and 32-bit for PCs and Macintosh— 
are available 

Infrastructure for Information Inc, 

344 Bloor Street West, Suite 400 
Toronto, ON 
Canada M5S 3A7 
416-920-6489 
http;//www. i4i.org/ 

Source Dynamics Ls shipping Source Insight 
2.1 for Windows 95/NT, a tod designed for 
large projects that has been enhanced to 
edit large, multiple-module Java applica¬ 
tions. Source Insight 2,1 also provides en¬ 
hancements to its C/C++ and assembler 
program-editing capabilities, introductory 
pricing for Source Insight 2.1 is $249.00. 
Source Dynamics 
22525 SE 64th Place, Suite 260 
Issaquah, WA 98028 
206-557-3630 

http: // www, sou reedy n . com/ 

Thunder & Lightning has released Web 
Factory Author 3.0, a web-page author¬ 
ing tool. Its features include dynamic 
WYSIWYG and HTML simultaneous edit¬ 
ing, image import, and conversions. The 
company also announced three add-on 
software modules; ImagEditor for image 
editing; Preview Library for content man¬ 
agement; and Dreamcatcher for web-site 
management. These modules may be 
added in any combination to the founda¬ 
tion product, Web Factory Author 3-0, The 
integrated suite of Web Factory software 
is available in a single product, Web Fac¬ 
tory Pro Image 3 0, Thunder A Lightning 
is distributing its products exclusively 
through downloads from its site and oth¬ 
er sites on the World Wide Web. Web Fac¬ 
tory Pro Image is available for Windows 
95/NT for $249,00 per copy. You can lease 
Web Factory Pro Image for $59 95 for three 
months. 

Thunder & Lightning Company 

6540 Lusk Boulevard, Suite C-212 

San Diego, CA 92121 

619-643-5550 

http: //www, tlco. com/ 

Catalyst SocketWiench is a WinSock custom 
control in the form of a VBX, usable with 
Visual Basic 3-0, the 16-bit edition of Visu¬ 
al Basic 4.0, or any software that supports 
the 2.0 VBX specification. The SocketWrench 
VBX works with any TCP/IP app dial pro¬ 
vides a WinSock DLL compliant with the 
Version 1.1 specification. With SocketWiench 
you can create a client or server applications 
using either TCP or UDP protocols, 
SocketWrench also includes a dialer cus¬ 
tom control in the form of a VBX that in¬ 
terfaces with Microsoft’s Remote Access Ser¬ 
vices. Tie .SocketWrench RAS control allows 
you to create a dialer for any host config¬ 


ured w ith RAS, All in all, SocketTools con¬ 
tains 13 custom controls that simplify Inter¬ 
net and Intranet application development. It 
includes a browser control as well as con¬ 
trols tor Cither TCP/IP protocols such as FIT, 
SMTP, POP3, NNTP f DNS, ICMP/PING, RAS, 
RLIB, Image Viewer, TELNET, ANSI, and 
SocketWrench. Catalyst SocketTools sells for 
$347,00 and Ls royalty free. 

Catalyst Development Corp. 

56925 Yucca Trail, Suite 254 

Yucca Valley, CA 92284 

619-228-9653 

http;//www. catatysucom/ 

Chiysalis-ITS has released its Luna data- 
encryption token and an SDK for develop¬ 
ing secure systems for electronic commerce. 
Luna is a security token that uses its on¬ 
board 32-bit RISC processor and up to I 
MB of memory for computing encode and 
decode data and provide digital signature 
verification. The SDK consists of two Luna 
tokens and Luna card readers, an ISA con¬ 
nection into a PC-based development sys¬ 
tem, PKCS+ll software and documentation, 
CK source code, and 60 days telephone/e- 
mail support. Tie Luna card Ls a standard 
Type II PCMCIA or PC card that plugs into 
a standard PC card interface on laptop com¬ 
puters. Luna PC cards are available in quan¬ 
tity for 30 day delivery. The single-unit price 
for the Luna card is $350,00, Tie Luna De¬ 
veloper's Kit Ls priced at $10,000.00, 
Chrysalis-ITS Inc. 

380 FI tint Club Road, Suite 200 
Ottawa, ON 
Canada K1V 1C1 
613-731-6788 

http ://www. chrysalis- its. com/ 

Zinc Software has introduced Zinc 
DataConnect (ZDC), a database middle¬ 
ware tod that provides C++ access to re¬ 
lational databases. ZDC provides database 
independence by supporting different data¬ 
base back ends with a single object-ori¬ 
ented C++ database API, Unlike ODBC, 
ZDC translates its own databa.se-indepen¬ 
dent function calls to native API calls for 
individual databases. ZDC can be hosted 
on Windows 3-1/95/NT, OS/2, Macintosh, 
DOS (Real, 16-bit, 32-bit), or UNIX. You 
can buy a Core Library and Database Ac¬ 
cess Modules for each database for which 
support is needed. Price indudes full source 
code, with no royalty or run-time fees. Tie 
Core Library costs $199-00 for PC platforms 
and $399-00 for UNIX. The Core Library 
with all Database Access Modules costs 
$2999,00 for PCs and $5999,00 for UNIX, 
Zinc Software 
405 South 100 East 
Pleasant Grove, UT 84062 
801-785-8900 
httpY/w'ww.zinc.com/ 
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Passport Corp. announced Passport IntR- 
prise T a tool that lets you build applica¬ 
tions that use Java front ends for Inter 
net/intranet deployment, yet support 
transaction processing, multitier architec¬ 
tures, and fault tolerance for enterprise 
computing. Passport IntRprise supports 
Windows 3.1/95/NT, UNIX, and Java. A 
single developer's license is $8995.00, 
Passport Corp. 

Mack Centre 111 

140 East Ridgewood Avenue 

Paramus, NJ 07652 

201-6344100 

http ://www. passport4gl .com/ 

Eastern Systems has announced TestWeb, 
a software-testing tool that nonintrusive- 
ly tests applications. It supports regression 
testing, benchmarking, and compatibility 
testing on x86 based PCs, embedded sys¬ 
tems, and systems that utilize proprietary 
user-input devices, TestWeb uses a sin¬ 
gle, comprehensive C-based LoolkiL. East¬ 
ern Systems also announced Test Bed 5 
for Windows 95/NT, an integrated toolset 
that provides programming standards ver¬ 
ification, structured programming verifi¬ 
cation, complexity metric measurement, 
variable crossreference, unreached code 
reporting, static control-flow tracing, and 
procedure call analysis. 

Eastern Systems Inc. 

RO Box 1087 
West boro, MA 01581 
508-366-3223 

h ttp://www j eastern s y stems, co m/ 

Interactive Software Engineering USE) an¬ 
nounced ESffeIWub, a library that provides 
scripting tools for developing CGI scripts 
Using Eiffel, Eiffel Web is supported on plat- 
tomis such as Windows 3-X/95/NT. SunOS, 
Solaris 2.4, 1 IP 9000, IBM R5/6QQ0, DEC 
Alpha OSF/1, Data General Avion, Silicon 
Graphics, Linux, 1 nix Ware, and SCO. 
Interactive Software Engineering 
270 Storke Road, Suite 7 
Santa Barbara, CA 93117 
805-685-1006 
http://www. eiffel .com/ 

WebManage Technologies has announced 
the release of Its Netlntellect log-analysis 
tod. Netlntellect is a 32-hi l Wind ows- based 
application that operates with any Common 
Log File or Combined Log File from any 
web, intraneL or Proxy server. Netlntellect 
lets you save or view reports and graphs as 
HTML, Microsoft Word, Microsoft Excel, Lo¬ 
tus, text files, raid so on, instead of only 
HTML or Microsoft Word files. You can also 
access 30 predefined reports, or customize 
them as needed (tables, 2-1) and 3-D 
graphs) by using various filters for hits, ac¬ 
cess time, bytes transferred, host name, file 
name, raid domain name. A trial version of 


Netlntellect is available by accessing the 
WebManage web site. The retail price for a 
single-user version of Netlntellect is $149.00, 
WebManage Technologies Inc, 

70 West Red Oak Lane 
White Plains, NY 10604-3602 
914-697-7555 

hup://w w w. wei rana nage, com/ 

Map Info has introduced S path 1 Ware, a 
server technology that provides spatial in¬ 
formation from a database source. Spatial- 
Ware uses Maplnfo mapping technology 
with Oracle's relational database system 
to let users store, manage, and analyze 
complex spatial data. Spatial Ware is avail¬ 
able for Sun Solaris and SCO UnixWare 
and supports Oracle v7.1.6 or v7.2,3* Prices 
range from $25,000 for a work group con¬ 
figuration to $200,000 for an enterprise 
server implementation, 

Maplnfo Corp, 

One Global View 
Troy, NY 12180-8399 
518 - 285-6000 

hupV/wwwanapinfo.eom/ 

SCH Technologies has announced a DEC 
Alpha version of its System'Watch systems- 
managemenl tool. System Watch manages 
disk space, memory, swap space, CPU uti¬ 
lization, host availability, database perfor- 
mance/avaflability, system/application pro¬ 
cesses, and system logs, System Wat clfs 
event management lets it take corrective 
actions without administrate]' intervention. 
System Watch sells for $695.00 with one 
year of maintenance. The program runs on 
DEC Alpha. Sun, HP, and IBM platforms. 
SCH Technologies 
895 Central Avenue 
Cincinnati, Gl 1 452024961 
513-579-0455 
1 lltp:// WWW. sell .corn/ 

AutoTester has announced Auto!ester Dis¬ 
tributed Test facility (DTE) 2.0 for dis¬ 
tributed testing of Windows and OS/2 GUI 
and client/server applications. You can use 
AutoTester DTP to execute and monitor 
tests created for Windows 3.X/95/NT and 
OS/2 across a network for load stress and 
performance testing. A combination of 
tests may be scheduled for simultaneous 
or synchronized playback across a com¬ 
bination of network machines. Prices be¬ 
gin at $15,000.00. 

AutoTester Inc. 

8150 N Central Expressway, Suite 1300 

Dallas, TX 75206 

214-3684196 

hup: //www, a u tot es t er. com/ 

Blue Sky Software ROboHELP i is a Help 
authoring tool that supports all Windows 
Help platforms and HTML-based Help stan¬ 
dards. RoboHELP 4 turns Microsoft Word 7 


into an authoring tool capable of creating 
professional Windows Help, HTML-based 
Help, printed documentation, and in- 
tranet/lntemet web sites, using a single 
source. RoboHELP 4 Is available for $499.00. 
Blue Sky Software 
7777 Fay Avenue, Suite 201 
La Jolla, CA 92037 
800459-2356 

http://www,blu e- sky .com/ 

The KL Group has released JClass BWT, a 
library of components that lets Java de¬ 
velopers create GUI applications and ap- 
plets. JClass BWT includes Outimer (hier¬ 
archical tree control), Image Button, Tab 
Manager, Multicolumn List, Header, Label, 
anti Scroll!xir, Tile JClass BWT components 
provide advantages over Java’s AWT such 
as consistent look and feel across platforms, 
dynamically configurable resources, and 
additional components. JClass BWT cosLs 
$49.00, or $199.00 with source. 

KL Group Inc, 

260 King Street East 
Toronto, ON 
Canada M5A 1K3 
4164944026 
liLlp: .//www. klg. Com/ 

ImageFX has announced PhotoPRO, a 32- 
bit ActiveX toolkit for adding a multitude 
of image display Lind processing capabil¬ 
ities to desktop and Internet applications. 
PhotoPRO provides image manipulation 
capabilities, TWAIN image acquisition, im¬ 
age printing capabilities, and image re¬ 
trieval via HTTP PhotoPRO is royalty free 
and has a suggested retail price of $499 00, 
ImageFX 

3021 Bright on-Henrietta Road 
Rochester, NY 1 14623 
716-272-8030 

htt p://www, i magefx.com/ 

Integral ion Ware has announced Speed 
Daemon for Delphi, a Delphi source- code 
profiler. The utility produces statistics for 
each function such as the number of times 
a function is called, the total time spent 
executing the function relative to other 
pieces, and average time per call. 5j>eed 
Daemon works with all Delphi 1.0 and 
2,0 applications, including DLLs and OLE 
automation servers developed in Delphi 
and single-threaded and multithreaded ap¬ 
plications, Speed Daemon does noL re¬ 
quire any changes Lo a project or source 
code. The regular price is $89.00. 
Integration Ware Inc, 

Deerfield Tech Center 
111 Deer Lake Road, Suite 109 
Deerfield, IL 60015 
888-773-1133 

htt p ;//www. Integra l ion wa re, com/ 
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Register for Software Development '97 West. March 31 -April i. Moscone. San Francisco 


That’s right SD is ten years old, and you can still count on us challenges r through the industry's most intensive technical 


to keep you up to speed on the entire spectrum of development conference. Master the fine art of managing the development 


technologies, issues and techniques. 

From C++ to Delphi to Java, if you use it to build 
applications, you'll use it more effectively after five 
prolific days at Software Development ’97 

This year, as always, you'll gain fresh insights 
directly from the creators of the most advanced tech¬ 
nologies. Learn new ways to meet your development 



process. And browse through a vast supermarket of 
more than 500 high-powered tools. 

To receive your SD '97 West catalog, call us at 
800.441.8826 or 415.905.2702, send us e-mail at 
sd97west@mfi.com, or visit our web site. You’ll be 
amazed at how much ingenuity a ten-year-old could 
contribute to your development team. 


More tools. More intelligence. 

www.sdd7.com 














Visit our website i http://www.Informngic.com 
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Windows OCX and DLL Controls 



SftTree Tree Control 

From simple listbox with bitmaps to multi- 
line,, multi-column, hierarchical data display, 
SftTree delivers! This 16-bit and 32-bft 
OCX control supports most popular 
environments including VB, Delphi, Access, 
etc. Also available as a DLL-based conlrol 
forC and C++. 

mM 

Not ThE lUOUSTR* STAHO+FtP 

11 Michigan Ave 
Wharton, NJ 07885 


B £ 

SftTabs 

it 

Tab Control 


This DLL-fcased custom 8 
control supports G, C++ ! 

(MFC, OWL), Windows 


3.L Windows NT and 
Windows 95 wHb over 50 j] 


different tab styles! 


Add tab controls to your ; 

.a 

16-bit and 32-bit 


applications with this easy £ 


to use tab control! 


Call today 
for your 
free demo! 


(201)366-9618 
FAX (201) 366-3984 

http ://www. s ofte I v d m. com 


I Hipparchus™ GI$ Enabling Technology 

/er 250 functions provide C or 0+ developers with breakthrough GiS capa- 
I bilities. Interface with any GUI and any DBMS. Ellipsoidal vector algebra 
enables seamless global coverage, lightning-fast spatial indexing, polygon 
overlay and morel 

New! Release 3,0 libraries for all 32- 

bit Intel platforms: DOS, Windows 95, 

NT r OS/2, Linux ($775). RISC Unix: 

Sun, IBM, DEC, HP, SGI and Mac 
($1475), Includes Application 
Prototyper, Tutorial, Reference and 
Georama extensible world Atlas on 
CD-ROM (Windows 95). 

Geodyssey Limited 

500,815 E#h Avenue SW, 

Calgary, Alberta, Canada W 3P2 
403-234-9848 Fdx 403-266-7117 
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NEW: 


e/Port I/O 
s'DPRAM 


[/Interrupts 


TM 

Hardware Control Lib/OCX 


Simple: No DDK development. Easily create and debug 
custom hardware control using VC++, V84, or Delphi. 
Fast: New Version 3 includes Kernel BASIC interpreter for 
running loops and ISRs entirely at kernel-mode for optimum 
performance. 


Create high-performance VxD, 
NT, and WDM kernel-mode 
t drivers from common source. 
Driver Framework C++ Class Library 

| The DFC library simplifies DDK development by providing 
base class implementations of many common driver tasks. 


High Quality Software Protection since 1989 


if tkccure against sy^omaoc "ci^ckw-s" 1 
if WlBU®’-flCKfar LPT, COM nd APB. USB. tnun- 
parent *nd astadablo, as PCCard and fEtlSA card 
if DOS, Windows™,Wlodcfws™ 9 5. Win daw n™ NT, 
M*cOS 1M .OSrl® Nondl 
if PrOLfiCtKKt WltllOUT iOLirtf Mde mc’Hificritinn 

if CD-ftOM Prarmion, 

if API Indcpcndani of inu^rnniiming Im'iynJi^ and 
lystom 

I |tn| 1 WlBLi-SYSTEMS AG 

LrtiLiM RuappUirw Stntu 5+ 
■■■■■I D-7*137 Kai-lsruho, Germany 

SYST F M S Tal 449 7219317243 & 9 317i-i2 

as 100141.1*74 Hdalgwlliu.de 


Wmu-KEY CD-ROM 
Software, online documentation 
and multimedia Introduction. 

WkLAN: network protection. 


tf UFFIN 

TECHNfXDGLB INC 
1*17 St Andrew Dr. UwrwvJfl.KS fi*CH7 
Ml? 13 WM07G FAX [913) 332-679 7 
CIS 71141.3624 ■ eimi silts am 


Does your application edit source files, 
macros or scripts? 


SourceView^ 

Add a syntax-highlighting text editor to your application with 
the SourceView editor library. Easily customized for any 
syntax. Examples provided for C, BASIC, and HTML. 


Tetradyne 

Software Inc. 


www.tetradyne.com 

(408) 377-6367 FAX: (408) 377-6258 tetradyne@mindspring.com 
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Dr. Dobb’s CD-ROM Library’s 

Essential Books on Graphics Programming CD-ROM 


n: 


7 of the most important books 

I eed to get up to speed on 
graphics programming— 
fast? There's only one definitive 
source you can turn to— 

Or, Dobb's Essential Books on Graphics Programming 
CD-ROM\ 

Get seven of the most-essential books on graphics 
programming, with full text, diagrams, graphics, and 
source code—all on one CD-ROM. From fundamental 


DDJ Editors 1 choices: 

* Zen of Graphics Programming , by Michael Abrash 

* Practical Image Processing in t by Craig A. Lindley 

* Photorealism and Ray Tracing in C, by Watkins, 
Coy, and Finlay 

* Applied Concepts in Microcomputer Graphics , 
by Bruce Artwick 

* Digital Halftoning i, by Robert Ulkhney 

* Digital Image Warping, by George Wolberg 

* Algorithms for Graphics and Image Processing , 
by Theo Pavlidis 


ever written on Graphics Programming 

algorithms to the most complex techniques, this 
CD-ROM lets you find all the critical information 
you need for your graphics programming projects. 

Texture mapping, _ 

color modeling, and 
morphing— all 
optimized for speedy 

2- D and3-D graphics 
programming. Practical 
image acquisition and 
processing. High quality 

3- D photorealistic 
graphics. 


Digital halftoning. 
Image synthesis and 
special effects. And 
much more! Plus, all 
source code supplied 
with the books is 
included. 

Price: $69.95 


Order Today! 
U.S. & Canada: 
800 - 992-0549 
All Other Countries: 

913 - 841-1631 

E-mail; 

orders@mfi.com 
Fax Orders: 
913 - 841-2624 


Mail Orders 

Dr. Dobb's CD-ROM Library 
1601 West 23rd Sl, Ste + 200 
Lawrence, KS 66046-2700 
USA 
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ASSEMBLY 




Pentium® Processor Optimizer 

Our software automatically annotates your assembly source with 
Pentium* processor optimization information (simulated pipeline 
pairing, AGI's, prefix stalls, register trace and more). Reports sta* 
tislics by loop nesting depth, ($199.95) ASM FLOW generates 
flow charts, lies diagrams, register analysis, x-ref. liming info and 
more-for 80x86, 8061. 8096, Z-80, 68HC11, 6SHC05, and 
more. ($199.95) Call tor froo demo and catalog of assembly, TSR 
and floating point libraries. ($99.95 to $299.95) 

Pentium is a registered trademark ol Intel. 

Quantasm Corp. 

19672 Stevens Creek Blvd S307-D 
Cupertino, CA 95014 
80(7765 8086 or 408-244-6826 
FAX: 408-244-7263 
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lN©ORYRIGHT 

Protect your creative work! 


Copyright Your Software 

Sure, you can put the © symbol on your software and 
documentation, but for full toga I protection, you must 
formally register your work with the U.S. Copyright 
Office. InCopyright is an easy, step-by-step Windows 
program that collects req'd. info and prints completed 
forms to your laser/inkjet printer. Saves time, money and 
maybe your job* F ul ly approved . Only $99 + S3 s&h. 


Parallel Resource, Inc, 

PQ Box Z 4 S 8 DO * Auburn, AL 36831 
( 334)621 - 9 DDD http://www.para! lelresource.com 
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C + + LIBRARIES 


WMTLIB C++ Multithread library 

Make miMbrcfld and mifitiproces^development^rmpder wishttie WM.TIIBCm 
clmsei, anil gain Drrcsi-ptolforiTi portability ul the ante time. 

WMTLIB indadei daises to nurap lyrnLirfliiisalHHi and data Innnslcf between 
threads, borli riilc-upc ticeis and inlerpiocteii, with documeoied swine, royally 
free Joplaymcnl, nod inesqwniive Ikensing per developer. 

Supports Win 32 (NT and WinflS). OS/2, Umxltmrfs, Solaris 2,5 (Solaris 
itireads and FQ5IX 1 DD3.lc), UrixWore 2.1, more m follow. 

Sole www.waitgold.coin lor more details. 

Weston gold JUd+ 

I omoii: info@westongeld.caia oi tail (+44) 1992 633801 
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introducing 


This visual development environment I--J 

takes away programming tedium. Program with 
built-in code patterns or build your own. Create your 
own CASE tools or custom documentation, 

Quintessofl Engineering. Inc. 

http://www. q mrrtessoft co m (313) 669-0192 


DEVELOPMENT TOOLS 


DEVELOPMENT TOOLS 


PARSING JUST GOT EASIER 


Pursing input used to mean tricky logic with lots | 
of places for bugs lo hide, slipped schedules, 
difficult maintenance. Nobody's idea of fun. 

Now, more powerful, more convenient, AnaGram I 
VI.5 changes all that. You can lake charge and con- f 
centmle on the real problems. Expressions? I 
| Database queries? Scripts? Command languages? I 
No problem. Call for free trial copy. 

Anagram* by Parsifal Software 
P.O. Box 219, Way land, MA 01778 
http:// www. parsi falsoft .com 
CIS: 72603+1763 info@parsifalsoft.com 

(800) 879- 2577 Voice/Fax (508) 358-2564 
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SPELL CHECKING & THESAURUS 


MULTI-LINGUAL 

I Danish Dutch French German Italian 

I Norwegian Spanish Swedish UK English US EngiistM 

I FIRST CLASS ■ AFFORDABLE ■ ROYALTY-FREE ] 

■ FAST - EASY - POWERFUL 
■ U.S. ENGLISH THESAURUS TOOLKIT TOO! 
AVAILABLE FOB DOS, WIN 3d, WIN NT, WIN 95, OS 12 

LexSaurus So nvv.v up, I nc, 

427-3 Amherst St, Suite 303, Nashua, NH 03063 
(603) 672-5941 * 1 -800-570-1984 * Fax: (603) G72-5934 
E-mail: inf o@lexsaurus.mv.com 


The McCabe 00 ToolSet™ 

like McCafce Object-Oriented fodSeti" is Hie newest addition to the 
I McCabe TmISvP". It provides n wide vviwfy afvyjfem metri&s and i dear 
I rigid lotion of 00 abdications archilecture. C++ systems cam bo fully 
1 tested md SAFE and UNSAFE slmes identified. Ts radius redurdaimy, 

I foe tonl finds reusable code tfinaugliaul a system. In addition, it contains 
area rums ttial help migrate systems fro rn traditional langurs lo 00, The 
lMeCabe T&dSef is a Isa available for ever 25 traditional ianguan&s and 
gdialects. ^ 

"•■McCabe 
r Associates^ 1 1 


I Uncover Your Software ■ 


HenCanSOO-eSd-SSiSor Fax 410-995-1528 




The easiest way to 
create an ODBC driver 
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Btrieve Database Access Fast & Easy! | 

iHlwnre Gei bliiidm^ pefSarOrtatt ind native access lo Btrieve 

J daiubuses wuhotii wwtjisjj. LDtfcf CM advHncrd rintn 
bciKluLf I ethnology mil perform* ihc VB data cimirnl, 
ODBC, Jet and <>ili=r *xcss rrclMds. Smith ware a 
ActiveX Coniroh gi* you k;i;il e> n:.ir> il nvc. r vom dnia 
^ilh ikhtiIcsb inlcf cation of Btrieve^ oJifitn^wjrVEj 
Controls for Btrieve u^ldiiled itficnMwsfis. MlKtdcd joined record f.as, 
hournE ennlrol* jeisI more. Use our Mmhols hi ynae lavortie develpjjnieiH includ- 
illy VB, Del|d|i. VC++, InicrtM Kspturer or In any fnvimututni ihm suppim* 
AtiiVcX, Yon can even enable your DppluEiuLiuu uver e|k web. Check oat isir 
hcnctunurti* jiiul tnlEmet denwE nl ft w W.5mi t h Wfl m.'UCliv^S nr rail m 

today and see tor youiBdf Jww Vmi ram get fusl easy act™ to yoiif Einevt Data? 

I Sntiihware, Inc. 

2ii6 Hillsboro Rflod, Suite301 Noihville.^l 37213 I 
Phone 613-304-31® or W0-B37-63td 
E-mgil- ^ib^smiti’Arare.cQra 
/ww. smilKwore.?orti 
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DEVICE DRIVERS 




Connect your proprietary database to the 
world's mast popular database tools such 
as Access, Visual Basic. PowerBuilder, and 
Crystal Reports. 


Dr. 

ODBC Tools 

Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why ft's just 
too sfow? It the ODBC 
driver is OK? 



I Custom driver development 
for Windows 3+1,95, NT, & OS/2. 


Kernel-modi; device drivers, VxD’s 
Printer & Graphics drivers 
Communications & Network solutions I 


Stratos Technology, Inc. 
31 Schanck Road, Suite D 
Freehold, NJ 07728 
908*780-5220 
Fax: 908-780-5302 
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Custom Device Drivers 
- Consulting - 



Dr. DeeBee utilities reveal the inner workings at ODBC, 


I Operating Systems: 


Call us today 
for a quote! 


-SWfflflEz - 

P.D, Box 91 Kendall 
Cambridge. MA 02142 


— El 7 - 497-137 S 

Fax 617*497-8729 
http: //www. syware. com 


Windows 95, 3.x, NT 
DOS, Embedded 

Rapid Development 
High Speed Execution 
Custom Hardware 


Device Drivers International, lie 


Sherman R. Couch 

Tel: 513-777-0895 
Fax: 513-723-5780 


Anthony A. Kempka 

Tel: 307-721-4381 
Fax: 307-721-8788 
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DEVICE DRIVERS ( GRAPHIC LIBRARIES ) ( NEW SCAN TOOCT 


Boost your Basic! 

Develop yourapp fasler: Get TeraTedi 
tools! 36VB, QB, PB, C & Xbase libraries 
available. Cali us and we'll mail you a 
free demo & booklet ASAP Call now! 




FREE demo! 


B - numaire 

__‘flmindaf 'ProBas - 4 other 15 DOS is 1 

* VwtUUPro ■ iPtephmy * VB training ■ 2 day intro dass 

* -illCMJVB 'C*m rC ■ASM.VBproqrarnmlnQ 1 

800-447-9120 <«t.i27S 

Depl 1275, IDO Park Avenue, Suite 36Q, RockvHe WD 2DS50 i 

lnfl:+1 -301424-3903 F<w:301 -762-3135 0BS3Q1-762-8104 

cftrn h*tr. 1 *ftfmwh 
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VICTOR 


Image Processin g Lib rary 

Fast BMP, TIFF. PCX, GIF.TGA. JPEG. Adjust brightness, 
contrast, sharpen, create fitters, reside, relate, + more of sin¬ 
gle image, multiple images, or any image area; color reduc¬ 
tion to optimum, specific, or s(d. palette; print; seen; crop, 
combine, compare, Wand images, EGA. VGA, SVGA, 

DOS $199 J 6-bit DU $299, 32-bit Dil $499 
Catenary Systems 
314-962-7833/fax; 314-962-8037 
www, cat© n a ry. com/v ictor 
ask for tree demo sre avail visa/mc/c.o.d. 
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DLL-OCX- VBX 

• Barcode recognition from bitmap 

• Barcode + test write into bitmap 

• Skew correction • Noise + Crop 

• Annotate image • Line removal 

• TIFF r/w - de/compress - fast scale 

I A , i w Tel: (714)964-6666 

Axtel, Inc, Fax: (714) 964-6766 


Free demo on http: www.axte l com 
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U/in-Emacs 

The Complete XEmacs Editor 
for Microsoft Windows® 

NEW! 32 -bit version 
for NT/Win95/Win 3.1 

To Order Call 1 - 800 -WIN-EMACS 


Pearl Software Corporation 

Tel: 510-652-4361 • Fax: 510-652-1362 

http://www.pearlsoft.conn/ 
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Homations Systems 

Graphic Hume Automation for Windows 95 

| Hu mat ion Baste - $1K9,V5 

Includes serial port X-IU Interlace 
Easy to use graphic stiff ware 
All 256 X-JO addresses 
Easy to use limers and events 
| Honmtion 2IKK! - *295 

Multiple floor plan layouts 
OLE Automation server 
Digital thermos tats - energy manage ntetil 


http ://www,li omation.com * 8(XL522-6054 Wk 


OTelli9enT Componeh^ 0 

I D et ;o^^^ e^c, P roduct ^ Java CGI and 

IpT-b^s^ss: 

'ill 

visit www.amzl.cam 

assssss 
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visit www.amzi.c 
Email Info & amzLcom I 
Cali +1 -508-897-73321 


B.S. & M.S. Image ITib eSa 


In Computer Science 


Rodney’s 

Copy Guard 


►ALL COURSES HOME STUDY 

* Approved for tuifcn reimbursement 
by leading corporations 

* Increase your earning power 

* C++, Using Windows, and Ada 
courses available 

* CareerPatfr training in computer 
programming available 

For free information cad: 

1-800-767-AICS 


AMERICAN 

INSTITUTE 

COMPUTER 

SCIENCES 

MTdiirra, 

#'#JJ AliiK'MIliM 

mtd Coif ffn 


Kcarrick" 


When you need to provide industrial 
strength encryption within your software 
projects, simply wire in carriok, 

1600 ENCRYPT 
www.encrYption.com 
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The SPINDRIFT Library Version 3.0 


The Complete FORTRAN Programmer’s Toolkit, 

I (rscre wpHrikflied suite ol-ifce an uiti irtfeiluces. For your FORERAN 
| programs. Spindrifl's to Untie subre ulinei ond funrtioiu ltf you 

* Hitvt ttaifl entry savem, dialog boxef, scrolling Nil bones 
poll-down menus, push tuitions, help panels, etc. All with lull 
manse support. 

* Much mare! 281 subroutines and functions For keyboard, 
screen,, monjie, DOS coniroL and hordworo slain; 

| ComprehEnsive datnflitrotion program shows what you loo do and hm to do if | 
Now shipping Ifcrxffln 30 with oil new User Guide. 

PRICE: 16 m Compilers - $149 32 Bit Compilers - $2fW 

I Spindrift Laboratories, Ltd. 

18 TangJew-oo-d Path * Galana - IL 811136 * USA | 
Phone: (015) 777-8240 * FAX: (8151 777 8241 
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LIBRARIES 

Complete C++ Math Library 

• Complete mu I tid I m eti*ton it * rr*y langu »ge 

* Complete package of nutlhematkc 

♦ Full error hand line package _ 

Advanced Support Modules 

Signal PriKHstng (NEW) Finite element 

Financial Utility (NEW) Least Squares 

_ Call for complete list _ 

FREE demo program on website 

hJtpV/www.woifmekcom^d^ dysd@woifenet.coni 
Dyad Software Corporation 

6W7Ct»ICkPkwy SEa36] Nmude WA 98059 
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| Delphi Software Protection 

True Native Delphi VCL wrapper not a DLL 
Used fixed or floating licensing scheme to 
protect your network application, 

FuFly event driven 

Does not use a Hardware Key or Disk Key 

| It's So Easy to: 

Add Password Protection 
Set applications to expire after 30-90 days 
Create fully/partiaiiy functional demo copies 
Setup Full Version or Demo mode 
Prohibit copying to unauthorized computers 
Specify the number of concurreru users that can run 
your application on a network 
| Sel applications to expire alter a given date or given 
number of executions 
"'PLUS MUCH MORE 

I One Tima Fee: 

1 te bit ....$159 
32 bit.... $159 

I Combo Pack (Both 16 and 32 bit) ...$199 
Call: 600-477-6163 or 619-669-6971 
I E-mail; sales® marote-com 
| Fax: 619-669-6914 

Marotz, Inc. 

1 60 day Guarantee www.marotz.com 
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| NEW! App-Linh RADX Control Set ■ LockOut Pirates! 

Lock In Profits! 


Rapid Application Data exchange 


THe HBW ADO-LP* RAQK HiillKN indirita J I 
VBX wid tfl.32 txl Aoj*t-X IOCfcOLE) cflnlrtiA | 
Use RAOX ta tii 

HAD* ayiWUypas MesMpe* cart be seni tw- J 
twwfi i C and 32 tut Dtstjqnns KmsRv w wt* a 9 
LANI RAtiK VEHVflWJ id Urei.aodrafc- 1 
JtJle T*m*e ^rn htgd quaht, n»S*agicq controls 1 


7 app KUtf mratfit an«m m$g rwicipl and miadi mem' Fcrg^l Rh hiESVw oT OOt, ] 
I NET DDE and OLE ■ Use App-LKih RADX- ftAQX Id nty 3149 and « ra *pltv frot 


Please visit our WWW site for details 

h ttp://www + s y ne rg y s w, co m 


I SynenoySntt^raTiwtiflflriOflieainc. 
I 15(4 Paarl Stjrct 

i Jwclxtn. Vermtml 05452 


BPD-2044L&14, tel WS2-B7B-fL514 | 
st@3ynergysw,a 


The Man? CRYPTO-flOX is Die result ol 
over 10 years experience in effective 
| sallware piolectiqu. 
p microprocessor controls ID codes, 
memory, dynamic algorllfim and 
big h speed data encryption UT 

t • remote access to passwords and counters 
| m license metering in nelworte: single key per LAM 

4M-3J1-3KS FAX: 4D4-3Z1 -0760 

1-800-MAR XINT 

L2D Erautiw Park Wes(. Seim 2027. Alania. GA 3D1M J 
iftfH aur How P>Bi: Wlp^^m.inaff .<aw 


id/.. 


IHTERMJIDtIAL. INC. 
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SECURITY 


D C 


SECURITY 


D C 


TOOLS 


3 



Az-Tech Software, Inc, 

Leaders in Software Security 

EVERLOCK 


(Softwnrc Baffd) 


IMMT 

CFERjOCK 

HMH.0CK CAFUn 

CMOMLOCK uafL"l/ 

REMOTE ACIlVATlQJi (Secure Uistrihution) 

ESECLT 10 .N LIMITS 
LIMJTEfi INSTALLS 

(Hardware Rased) 

Phone: (816) 776-2700 i325 
Fax: (8L6> 776-839S * T>«pt; S1MLG^:J25| 
Internet: www.nz-tech.cotn 
E-Mail: 9ales^az-tcch,CDni 


EVERKEY 


REMOTE RESETS 
SERIALIZATION 
kEOEswiriN 
ACOT FLAGS 
DATE LIMITS 

imnurrs 

"POI YU SHOOT" 

mm i i u^os 


CrypKey Software Licensing System 

‘’Software protection widi NO hardware lock and NO disk key u 

• u mtlware copy' protect uwi IhiL a 


■ i + • ■■ i«i IncrMH itot mllware imn: 

■ jpirli Dptlmis -and levtb ul your raftwarr 

- iiJi-w- er jw wnmaie by rum or em« 

- or upgritde iiiu iuof un'm ImtnnLly by phurte. fa 


tfewl uroqus Heady To Try J -ealure:- upon risUt Muni I tr-jl period ■ur->v per 
Nfeyrl urK)ue XdiJ Ofi lyaluic-add irure uplkxit. levels, mro dt Mine Id existing Ik 
Hf^vi rrypKsy imt*nt-proi«is m \m\ 5 rulnulw wSlfo no eu* (lunges. 

■ ■>] ' L ■ v it ^curplreuy rvtfflipjfetJlc wtlfi IWS-ffiJS, ft4S-WH*r»rt J.k, WInIZl, WI(W5, VI 
■Mid iVi,Vi,>4iis ii*itw>k fceiiSfiS on Jfl Novel -Hid MCrtSOll operVjig syjMffl -idstd netvwjrki. 
CrypKey is produced bfKmmc Cotibrols Lid ■ enymrcii’g and srllvv.in- sm 1H iV 


KmmiivU Comnm LHiirtud 
7175 12Cti Street Voirth Last 

Calgary. Aibcrt.i. Canada TZ»I 756 
<4EH1 J5S-6 -JOOTpx; |401> 250 6201 
IkTIlHfT DypkeirO' 


IMS: http: / j www . k-ou dti k a am/rrypl■ y . htm I 


C and C++ DOCUMENTATION TOOLS (v. 6.2) 


■ C-CALL ($G9) ilTaptoc-lTee ol KllBrttiilltd lurtction tii«ranc^ tress-rfifenmcB. 
i , ila/1unctKKi mdex 

■ C-CMT ($69j Crcaievi n-]n l^upifalE-- camflnftt'tiletcla (fun ril nnsAd e n tifief s 
Died) tor cud; Function 

- C-METTtlC ($59) Calculates pull! complexity, coii'its imes with cmnmBnts. cctte, 
r C slatemenJs 

• C-liST (569) Luts 3iid aclMn-iiiiQrJJms, or rflfiwtnct? sautCB Into usef-sote'CtMl 
stan-ln rd Igrmjrts 

* CHEF (SG9) Creates mras-ftterenca m localr'ylolwhiclEf ii'-fc-DSf a ouster idcnlllitrs. 
*C DOC (¥139) PACKAGE Ail 5 iKNiqrants intopiateit us DOS puxirum. <10,00(1 

IIIWS. C-EROWSE Wlmhws OraphiC-lfccvluwor 
■CHOC Proles l0 mil ($?99) DOS. Wmdarts, 0S.'2. 3-nng binderfcasE 
PrDCHSses 1,000,000+ lines. 


I SOFTWARE BLACKSMITHS INC. e ™'' ® swbs com 
| 6064 St Ives Way, Mississauga Voic&Tax (905} 858*4466 
titipJAkww.swbs.com 




ONT Canada L5N-4M1 
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DOCUMENTATION TOOLS 


Willows Software 

http://www.wiMows.com 

kit for p< 


UseTha Willow* TooUdt tor porting 19- and 32-faK Windows 1 
MacJnto 


applications to UNIX, Macintosh, reaUUmo, network and 
NC operating systems, JAVA, and other platforms. 


EMBEDDED systems 


WIND RIVER SYSTEMS 


http://www.wrs.com 


ANCUACES/DEVELOPMENT tools 


w ww. i nte I. c o m/ial/vf u ntf^i n dex/htm I 


INTERACTIVE SOFTWARE ENGINEERING 


http://www.eiffeLcom 


miscellaneous 


http://www.careermosaic.com/ 
em/symantec/home.html 


UTILITIES 


http://www.numega.com/ 


t^rzi Crii L— 2 Sc’ 1 Lr^ii 






















































SWAINE'S FLAMES 



Is Thin In? 


M o asked joe, “So what are you grinning about?” Joe Weaver was indeed grinning over his 
cream soda when Maureen “Mo” McRean walked into Foo Bar that night. British journalist 
Larry Wilde and I had each tried to find out what Joe was so tickled about, but he was 
apparently waiting For a full house. Now the place was about as full as it gets, with three very 
regular customers and me, the relief bartender 

“Oh, nothing/ Joe answered, “Well, something, t guess." He was obviously bursting with pride. 
“One of my leads got picked up tor a cover blurb," 

“So some of your deathless prose appeared on the cover of that barf hag you write for?" 

“IPs called Words on the Wing” Joe sniffed. “Its an in-flight magazine/ 

"That’s what I meant. Give n>e a leinenkugel, Mike, It s like that old joke about Niklaus Wirth, 
the inventor of Pascal. In Europe they pronounce it 'nee-claus veerf, but in America they 
pronounce it Tiickle’s worth/ It s the difference between call-by-name and call-by-value/Joe had 
die look of a surfer who, riding a big wave a second before, has just caught his lx;ard in the back 
of the head. Larry threw him a line. 

“What was the lead, Joseph? I dare say it was something clever if they picked it up for the 
cover/ 

“‘Don't know paperback from pay-per-view?"" Joe said, in that pompous sing-song voice 
writers always use when quoting themselves, “‘Check out our massive media review. 1 ” 

Mo snorted. “That was your lead? It sounds like ad copy!" 

There was a moment of awkward silence, I wiped the bar, chipping away with my thumbnail 
at a chunk of bar grit that I suspected may have been a peanut in happier times. 

Mo gave Joe a sidelong look, sighed, and gave in. “Cute, though/ she said, hating herself for 
doing It, 

"Do you think so?” joe bubbled. It s hard to keep anyone as carbonated as Joe down for long, 
“Cute is what l was going for. It s the hallmark of my style/ he added, making it sound like 
another self quote, 

“Yeah, well/ Mo conceded grudgingly, “style matters. I guess/ 

“Style/ Liny proclaimed, “is all. It is the sole end of all an. the true message of most speech, 
anti the one quality that makes the humblest Briton superior to the entire Royal Family." 

“Well, 1 write about the computer industry'/ Mo said. “Wouldn't you say style is less important 
there?" 

H 1 would not, and I can give you an example. List year, Oracle's Liny Ellison gave a bombastic 
speech telling developers, essentially, that they'd better jump on the Network Computer 
bandwagon before the NC crushed the PC into dust. Did his brash style alienate developers? It’s 
possible. Style matters/ 

“Oracle, Isn't their net address oracle tide lphi.com?” 

“You make my point for me, Ellison's style invites just that sort of disparaging gag, 
however lame,” 

“Well, we all knew he was not PC/ 

“Please! Bul the whole future of these NCs, these thin clients, hangs on a style question; Is 
thin in?” 

“Speaking of thin computers/ Joe cut in, “have you seen Apple’s Shay? It's a Newton With a 
keyboard in a clamshell case that Apple plans to sell as a laptop/ 

“Beastly name, Shay/’ Larry said, sipping thoughtfully at his white wine, 

“Still, I suppose they could hardly call it the Clamshell Newt T newts being amphibians rather 
than crustaceans," 

"Newt Gingrich is a crustacean." 

"You may have something there. Doubtless you caught it from Maureen/ 

“Anyhou, you have to hand it to Apple," Joe said, “the thing sure is cute/ 

Mo drained her glass and dunked it on the bar. “Cute. Right, 1 believe that’s the hallmark of 
their style/ 
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Now discover CodeBase 6—The fastest and smallest 
database engine available with xBASE file compatibility! 


Query a million records in just 0.97 of a second, 
or add ten thousand records in just 2.17 seconds. 

Discover these valuable benefits of CodeBase: 

• C, C++, Visual Basic, Delphi and Java are 
all supported 

• FoxPro, Clipper and dBASE file support, 
including full multi-user compatibility 

• Runs under Windows 95, NT, 3.1, DOS, Mac, OS/2, 
Solaris, SunOS, A1X, SCO, Linux, UnixWare... 

• Tiny libraries help apps load quickly and 
use less memory 

■ 100% royalty-free client/server 
configuration included 

• Transaction processing and logging 

• Crash recovery is built-in 

■ Full featured report writer included 

• Source code included 

• Royalty free distribution 

New ActiveX 

Seamlessly integrate our fast database 
engine with your favorite compiler using 
our new ActiveX database support. 
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Award- Winning performance 5 years in a row! 

“CodeBase gives ACT! the fast database access 
contact management users need’’ 

- Michael Plasterer, Director of Development, 

Symantec 
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1 Test Drive 

Test drive the new CodeBase 6 
for 30 days with your own code. 
No risk. No obligation. 

Order yours today. 

Cali: 403-437-2410 
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It takes too long to write everything 
in C++, so we write the user interface 
in Delphi. It really propels us through 
application development. The DLLs 
to actually run the instruments are 
written in C++. This works very well 
for us, 99 

—Doug Weigel. MTS, Hewlett-Packard 

Borland's Delphi 2.0 gives developers 
a language almost as readable 
as BASIC, but a whole lot faster 
and with genuine object orientation. 

It features performance competitive 
with comprehensive development 
environments such as Microsoft's 
Visual C++. 9 9 

-David Berltod, PCHWLabs, Apnf 1996 


To gat up and running quickly, 
Delphi 2.0 includes: 

Using Delphi with C++ Reference 

V FREE best-selling book 

Teach Yourself Delphi 2 in 21 Days 

yd Step-hystep online tutorials 

yd Easy-to-use visual tools 

yd More than 90 reusable components 

%d The worlds fastest 
native-code compiler 

yd Fall-featured Integrated 

Development Environment (IDE) 

yd Support for 16- und 32-hif 
development 


FREE! 
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New Delphi" 2.0 is the perfect complement to C++ —it propels C++ programmers through application development. With Delphi 2.0, 
you can rapidly prototype a functional application shell and drastically reduce the time it takes to build a complete application interface. 
You can even easily host Delphi Ul forms in MFC or OWL. 

Unlike Visual Basic, Delphi offers C++ developers two major advantages: small, fast executables that run well on Windows 3.1, 
Windows 95, and Windows NT, and a unique combination of a native-code compiler and visual development that minimizes coding. 
Take advantage of drag-and-drop development with more than 90 reusable components right in the box, or easily create your own and add 
them to the Component Palette. Be productive with a full-featured IDE that includes integrated debugging, tracing, easy-to-understand 
error messages, and color syntax highlighting. Even use or customize ActiveX controls right in the Delphi environment with full 32-bit 
support for OLE automation. And, to get you started right away, Delphi 2.0 includes a step-by-step online reference designed exclusively 
for C++ developers that shows you how to link C++ code to a Delphi UL Plus, you’ll get the best-selling book, Teach Yourself Delphi 2 in 
21 Days, absolutely FREE. 

For more information on Delphi 2.0, call 1-800-336-6464, ext. 50854, or check out Borland Online at http://www.borland.com/delphi99/ 
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